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Presentation of Guidelines Hosted by MathWorks 


This presentation of the MathWorks Automotive Adqvisory Board (MAAPB) 
guidelines, Verslion 2.1, 1s based on the qocument, of the same title, authored 
by the MAAB working group. In addition to the information included in the 
original document, this presentation includes references to corresponding 
Model Adqvisor MAAB checks that you can apply 计 you are licensed to use 
Simulinke and Simulinke Verification and ValidationIM software， 


NMotivation 





Mofivafion 


The MathWorks Automotive Advisory Board (MAAB) guidelines are 
important for project success and teamwork 一 both in-house and when 
cooperating with partners or Subcontractors. Observing the guldelines 1s a 
key prerequlslte to achlieving: 

e Problem-free system integration 

e Well-defined interfaces 

e Uniform appearance of models, code, and dqocumentation 

e Reusable models 

e。 Readable models 

e Problem-free exzchange of models 

e A Simple, effective process 

e Professional documentation 

e Understandable presentations 

e Fast software changes 

e _ Cooperation with subcontractors 


e Successful transitions of research or predevelopment projects to product 
development 
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Guideline Template 


In this secfion..。 





“Guideline ID”on page 1-5 
“Guideline Title” on page 1-5 
“Priority” on page 1-6 

“Scope” on page 1-7 

“MATLAB Verslions”on page 1-8 
“Prerequlisites”on page 1-8 
“Description ”on page 1-8 
“Rationale” on page 1-9 

“Last Change”on page 1-10 

“Model Advisor Check”on page 1-10 











Guideline dqescriptiongs are dqocumented,， using the following template. 
Companles that want to create additional guidqelines are encouraged to use 
the same template. 


ID: Title XX_mnnn: Title ofthe guidqeline (unidque, short) 
Priority Mandatory, Strongly recommended, or Recommended 
Scope MAAB, NA-MAAB, JMAAB, Specific Company (for 


optional local company Usage) 


MATLABY? One of the following: 
Versions All 

RX, RY, RZ 

RX and earlier 

RX and later 

有 人 X through RY 


Prerequisites Links to guidqelines，which are prerequlsites to this 
guldeline (TD: Title) 


Guideline Template 





Description Description of the guideline (text, Images) 


Rationale Motivation for the guideline 

Last Version number of last change 

Change 

Model Title of and link to the corresponding Model Advisor checkKk， 
Advisor 寺 a check exists 

Check 


Nofte The elements of this template are the minimum required items for 
understanding and exchanging guldelines. You can add project or vendor 

各 eldqs to this template as long as their meaning qoes not overlap with exlisting 
fieldqs. Such additions are encouraged ifthey help to integrate other guideline 
templates and lead to a wider acceptance of the core template. 


Guideline 1D 


e The guideline ID is built out of two lowercase letters (representing the 
origin of the rule) and a four-digit number, separated by an underscore. 


e Once anew guldeline has an ID, the ID dqoes not change. 
e The ID is used for references to guidelines. 


e The two letter prefixes na, jp, jc and eu are reserved for future MAAB 
commalttee rules. 


e Legacy prefixes, db, jm, hdq, and ar, are reserved. The MAAB committee 
will not use these prefixes for new rules, 


e No new rules are to be written with these legacy prefixes. 


Guideline Title 


e The title should be a short, but unidque description of the guidelines area of 
application (for example, length of names) 


e The title is used for the Prerequisites fieldq and for custom checker tools. 


e Thetitle text should appear with a hyperlink that lnks to the gulideline. 
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Nofte The title should not be aredundant short qdqescription of the guidelines 
content, because while the latter may change over tme, the title should 


remalin stable. 





Priority 


Each guidqeline must be rated with one of the following priorities: 


e Mandatory 


e Strongly recommended 


e Recommended 


The priority describes the importance of the guideline and determines the 


consequences of violations， 


Mandatory 


Sirongly 
Recommended 


Recommended 





Definition 





Guldelines that all 
companles agree to that 
are absolutely essential 


Guidelines that all 
companies conform to 
100% 





Guldelines that are 
agreed upon to be 

a good practice，but 
legacy models preclude 
a_ company 位 om 
conforming to the 
gulideline 10096 


Models should conform 
to these gulidelines to 
the greatest extent 
posslible; however， 
1009% compjliance is not 
requlred 





Guldelines that are 
recommended to 
Improve the appearance 
of the model diagram， 
but are not critical to 
running the model 


Guldelines where 
conformance ls 
preferred，but not 
requlred 





Consequences: Ifthe guideline ls violated， 





Cuideline Template 








Mandatory Sirongly 


Recommended 


Recommended 





了 ssential items are 
mlssing 


The quality 


The model milght not Ce 


Work properly 


and appearance 


An adverse effect 

on maintainabllity， 
portabillity，and 
reusabillity milght occur 


The appearance does 
not conform with other 
projects 





Waiver Policy: If the guideline is intentionally ignored， 





The reasons must be 
documented 











Scope 


The scope of a guideline may be set to one of the following: 





Scope 


Description 





MAAB (MathWorks Automotive 
Advisory Board) 


J-MAAB (Japban MAAB) 


Agroup ofautomotive manufacturers 
and suppliers that work closely 
together with MathWorks. MAAB 
Includes the subgroups J-MAAB and 
NA-MAAB. 


A subgroup of MAAB that includqes 
automotive manufacturers and 
Suppliers in Japan and works 
closely with MathWorks. Rules with 
J-MAAB scope are local to Japan. 





NA-MAAB (North American MAAB) 





A subgroup of MAAB that includqes 
automotive manufacturers and 
suppliers in the United States and 
Europe and works closely with 
MathWorks. Rules with NA-MAAB 
Scope are local to the Unlited States 
and Europe. 
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NMATLAB Versions 


The guidqelines support all versions of the MATLAB and Simulink products. 芋 
the rule applies to Specific versions, the versions are identified in the MATLAB 
versions fieldq. The version information ls in one of the following formats. 




















Format Definition 

All All versions of MATLAB 

有 了 X, RY, of RZ A specific version of MATLAB 

RX and earlier Versions of MATLAB until version 及 又 

RX and later Versions of MATLAB 位 om verslion RX to the current 
Verslon 

了 RX through RY Versions of MATLAB between RX and RY 








Prerequisites 


e The Prerequisite field is for links to other guidqelines that are preredquisites 
for this guideline (Logical conjunction)， 


e Use the guidqeline ID (for consistency) and the title (for readqability) for 
the links， 


e。 The Prerequisites field shouldq not contain any other text. 


Descripfion 


e。 This field contains a detailed qescription of the guidqeline， 


e。 If neededq, add images and tables. 





Note If formal notation (math, regular expression，sSyntax diagrams， 
and exact numbers/limits) is avallable, use it to unambliguously qdescribe 
a guidqeline and specify an automated check，However,，a human， 
understandable, informal qescription must always be provided for qailly 
reference. 





Cuideline Template 





Rafionale 


This field lists the reasons that apply for a given guideline， You camn 
recommend guidqelines for one or more of the following reasons: 





Rationale 
Readabillity 


Description 


Easlly understood algorithms 
e Readable models 


e Uniform appearance of models，code, and 
documentation 


e Clean interfaces 


e Professional documentation 





Workflow 


Effective qevelopment process and workflow 
e。 Ease of maintenance 


e。 Rapid model changes 
e Reusable components 
e Problem-free exchange of models 


e Model portability 





Simulation 


Verification and 
Validation 


Efcient Simulation and analysis 
e Simulation speed 


e Simulation memory 
e Model instrumentation 


Ability to verify andvalidqate a model and generated 
code with 
e Requlrements traceability 


e Testing 
e Problem-free system integration 


e Clean interfaces 





Code generation 





Generation of code that is efficient and effective for 
embeddqed systems 
e East software changes 


e Robustness of generated code 
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Last Change 


The Last change field contains the document verslon number. 


NModel Advisor Check 


The Simulink Verification and Validation product includes Simulink Model 
Advisor MAAB checks, which correspond to a subset of MAAB guidelines， 
that you can Select and run with the Simulink Model Advisor. In this 
presentation of the MAAB guidelines, MathWorks includes a Model Adqvisor 
check field in guidqeline qescriptions, which contains the title of and a ]ink 
to the correspondqing Model Adqvisor check, if a check exists. Although this 
information ls Included, note that the MAAB working group takes a neutral 
stance on Tecommendations for style guide checkers. 


For a list of available Model Advisor checks for the MAAB guidelines， 
see“MathWorks8 Automotive Adqvisory Board Checks”in the Simulink 
Verification and Validation documentation， For information on using 
the Model Advisor, see“Consulting the Model Advisor” in the Simulink 
documentation. 


Document Usage 





Documentf Usage 
e Chapter 2，Naming Conventions” and Chapter 3，“Model Architecture” 
provide basic guidqelines that apply to all types of models. 


e Chapter 5“Simulink”and Chapter 6“Stateflow”deal with specific rules 
for those environments. 


e Some gulidelines are qdependent on other gulidelines and are explicitly listed 
throughout the document. 


For information on automated checking of the guidqelines, see Appendix A， 
“Recommendations for Automation Tools”. 
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Namling Conventions 


e “Weneral Guldelines”on page 2-2 


e “Model Content ”on page 2-7 


2 Naming Conyentions 





General Guidelines 


e ar 0001: Filenames 


e ar 0002: Directory names 


cr 0001: Filenames 





ID: Tifle ar_0001: Filenames 
Priorify Mandatory 

Scope MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion A file name conforms to the following constraints: 


Form 


TI7Iemame = name.extemSIom 


e mame: no leading diglits, no blanks 


e extemsionm: no blanks 


Uniqueness 


All 人 le names within the parent project qirectory 


Allowed Characters 


门 a1m1e : 

abcdefghijklmnopqrstuvwxXxyz 
ABCDEFGHIJELMNOPQRSTUVWXYZ7 
0123456789_ 


exXtemSsIonm: 
abcdefghijklmnopqrstuvwxXxyz 
ABCDEEFGHIJELMNOPQRSTUVWXYZ 
0123456789 


Underscores 


门 a1e : 
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cr 0001: Filenames 





Raftionale 


Last 
Changed 


Model 
Advisor 
Check 


e Can Use underscores to separate parts 
e Cannot have more than one conSsecutive Underscore 
e Cannot start with an underscore 


e Cannot end with an underscore 


exXxtemsIon: 


Should not use Underscores 


e Readability 
e Workflow 


V1.0 


By Task > Modeling Standardqs for MAAB > Naming 
Conventions >“Check for incorrect file names?” 


ar _ 0002: Directory names 





Priorify Mandqatory 
Scope MAAB 
NMATLAB All 
Versions 


Prerequisites ”None 


Descripfion A directory name conforms to the following constraints: 
Form 
qzPrectory mame = mam1e 
name: no ljeading digits, no blanks 
Uniqueness 
All qirectory names within the parent project dqirectory 
Allowed characters 


门 a1me : 

abcdefghijklmnopqrstuvwxyz 
ABCDEFGHIJELMNOPQRSTUVYWXYZ7 
0123456789_ 


Underscores 


门 a1e : 


e Can Use underscores to separate parts 
e Cannot have more than one conSsecutive Underscore 
e Cannot start with an underscore 


e Cannot end with an Underscore 


Rafionale 。Readability 
e Workflow 


ar _ 0002: Directory names 





Last V1.0 

Changed 

Model By Task > Modeling Standardqs for MAAB > Naming 
Advisor Conventions >“Check folqer names?” 

Check 
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ar _ 0002: Directory names 





NModel Content 


jc_0201: 
jc_0211: 


blocks 


jc_0221: 
jc_0231: 
na_0014: 


USsab1le 
Usab1le 


USsab1le 
USsab1le 


Use of 


characters for 


characters for 


characters for 
characters for 


1Local language 


Subsystem names 


Inport bJocks and Outport 


Signal 1Line names 
block names 


in SimulLink and Statef1Low 
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ic_0201: Usable characters for Subsystem names 
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ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


jc_0201: Usable characters for Subsystem 
Strongly recommended 
MAAB 


All 


None 


The names of all Subsystem blocks should conform to the following 
constralnts: 


Form 


门 a11e : 


e Should not start with a number 


e Should not includqe blank spaces 


Allowed Characters 


门 a11m1e : 

abcdefghijklmnopqrstuvwxXxyz 
ABCDEFGHIJELMNOPQRSTUVYWXYZ 
0123456789_ 


Underscores 


门 a11e : 


e Can Use underscores to separate parts 
e Cannot have more than one conSsecutive Underscore 
e Cannot start with an Underscore 


e Cannot end with an underscore 


ic_0201: Usable characters for Subsystem names 





Raftionale 


Last 
Changed 


Model 
Advisor 
Check 


e Readability 
e Workflow 


e Code generation 


V2.0 


By Task > Modeling Standardqs for MAAB > Naming 
Conventions >“Check subsystem names?” 
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ic_0211: Usable characters for Inport blocks and 
Outport blocks 





ID: Tiftle 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


jc_0211: Usable characters for Inport blocks and Outport blocks 
Strongly recommended 
MAAB 


All 


None 


The names of all Inport blocks and Output blocks should conform to 
the following constraints: 


Form 


门 a11e : 


e Should not start with a number 


e Should not includqe blank spaces 


Allowed Characters 


门 a11m1e : 

abcdefghijklmnopqrstuvwxXxyz 
ABCDEFGHIJELMNOPQRSTUVYWXYZ 
0123456789_ 


Underscores 


门 a11e : 


e Can Use underscores to separate parts 
e Cannot have more than one conSsecutive Underscore 
e Cannot start with an Underscore 


e Cannot end with an underscore 


ic_0211: Usable characters for Inport blocks and 
Outport blocks 





Raftionale 。Readability 
e Workflow 


e Code generation 


Lasf V2.0 

Changed 

Model By Task > Modeling Standardqs for MAAB > Naming 
Advisor Conventions >“Check port block names?” 

Check 
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ic_0221: Usable characters for signal line names 





ID: Title jc_0221: Usable characters for signal lne names 
Priorify Strongly recommended 

Scope MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion Idqentifies named signals constraints 


Form 


门 a11e : 


e Should not start with a number 
e Should not includqe blank spaces 


e Should not include any control characters 


Allowed Characters 


门 a1m1e : 

abcdefghijklmnopqrstuvwxXxyz 
ABCDEEFGHIJELMNOPQRSTUVYWXYZ 
0128456789- 


Underscores 


门 a11e : 


e Can Use underscores to separate parts 
e Cannot have more than one conSsecutive Underscore 
e Cannot start with an Underscore 


e Cannot end with an underscore 
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ic_0221: Usable characters for signal line names 





Raftionale 


Last 
Changed 


Model 
Advisor 
Check 


e Readability 
e Workflow 


e Code generation 


V2.0 


By Task > Modeling Standardqs for MAAB > Naming 
Conventions >“Check signal labels for incorrect characters?” 
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ic_0231: Usable characters for block names 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Raftionale 


jc _0231: Usable characters for block names 
Strongly recommended 
MAAB 


All 


jc_0201: Usable characters for Subsystem names 


The names of all blocks should conform to the following constraints: 


Form 


门 a11e : 


e Should not start with a number 

se Should not includqe spaces at the beginning of a block name 
e Should not use double byte characters 

e Carriage returns are allowed 

Allowed Characters 


门 a11m1e : 

abcdefghijklmnopqrstuvwxXxyz 
ABCDEFGHIJELMNOPQRSTUVWXYZ 
0123456789_ 





Nofte This rule does not apply to Subsystem blocks. 





e Readability 
e Workflow 


e Code generation 


ic_0231: Usable characters for block names 





Last 
Changed 


Model 
Advisor 
Check 


V2.0 


By Task > Modeling Standardqs for MAAB > Naming 
Conventions >“Check block names for incorrect characterSs?” 
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na_0014: Use of local language in Simulink and 
Stateflow 





ID: Tiftle 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 
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na_0014: Use of local language in Simulink and Stateflowse 
Strongly recommended 
J-MAAB 


All 


None 


The local ljanguage shouldq be used in dqescriptive fielqs only. Descriptive 
fieldqs are text entry points that do not affect code generation or 
Simulation. Examples of descriptive fieldqs includqe the Description 
field in the Block Properties qialog box. 


Simulink Examples 


e。 The Description field in the Block Properties dialog box 





Block P ropert IeS 





General || Block Annotation || Callbacks 





Usage 


Descriptior: Text saved with the block in the model fIIe. 

Priority Specifies the blocks order of execution relative to other blocks imn the 
same mode|. 

Tag: Text that appears in the block label that Simulink generates. 


Descriptior': 


Local language can be Used. 














e Text annotation entered directly in the model 


na_0014: Use of local language in Simulink and 
Stafteflow 








Description: Local language can be Used. 


Duti Int 


Dut2 In2 


Stateflow Examples 


e The Description field of chart and state Properties 
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na_0014: Use of local language in Simulink and 
Stateflow 








“] State State 


Local language can be Used. 


e。 Annotation dqescription added using Adqd Note 





na_0014: Use of local language in Simulink and 


Stafteflow 





Raftionale 


Last 
Changed 


Model 
Advisor 
Check 





全 
Local /iage ca pe Used 
[condition] 
〈( 所 / { 
上 dd Note 
语 丰 
[action| 
UPDD7 
让 记忆 
Back 《 ) (《 
SA < 





Note It is possible that Simulink cannot open a model that includes 
local ljanguage on different character encoding Systems. Therefore, pay 
attention when using local characters for exchanging models between 
countries. 


e Readability 
e Workflow 


V2.0 


By Task > Modeling Standardqs for MAAB > Naming 
Conventions >“Check signal labels for incorrect characters?” 
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na_0014: Use of local language in Simulink and 
Stateflow 








Model Archltecture 


e “Simulink and Stateflow Partitioning”on page 3-2 

e “Subsystem Hierarchles”on page 3-14 

e J-MAAB Model Architecture Decomposition”on page 3-21 

This qdocument uses the term basic bocAps to refer to blocks built into 


the Simulink block libraries.“Baslic Blocks”on page D-2 in Appendlix D， 
“Background Information on Basic Blocks and Signals”lists Some examples of 


baslic blocks. 


3 NModel Architecture 





Simulink and Stateflow Partifioning 


e na_0006: Guidelines for mixed use of SimuJlink and StatefJow 


e na_0007: Guidelines for use of Flow Charts，Truth Tables and 
State Machines 


nc 0006: Guidelines for mixed use of Simulink and 


Stafteflow 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


na_0006: Guidelines for mixed use of Simulink and Stateflow 
Strongly recommended 
MAAB 


All 


None 


The choice of whether to use Simulink or Stateflow to model a given 
portion of the control algorithm functionality should be driven by the 
nature of the behavior being modeled. 


e If the function primarily involves complicated logical operations， 
use Stateflow diagrams. 


Use Stateflow diagrams to implement modal logic，where the 
control function to be performed at the current time dqepends on a 
combination of past a7q prese1t /osicQal co1QIo7.S. 


e。 Ifthe function primarily involves numerical operations, use Simulink 
features. 


Specifics 


e。 If the primary nature of the function is logical, but some simple 
numerical calculations are done to Support the logic, Implement the 
simple numerical functions using the Stateflow action language, 


nc_0006: Guidelines for mixed use of Simulink and 
Stateflow 








Bi 怠 Ykn Smdxan Tcag ndd Hop 全 


碎 园 要 | 了 喇 国 | 志 吕 十 | 受 国 | es | 岗 昌 图 | = 


Embedded simple 
math operation 





e。 If the primary nature of the function is numeric, but some Simple 
loglcal operations are dqone to Support the arithmetic, Implement the 
simple logical functions with Simulink blocks. 





上 让] naonon6sparc2/y/ 吕 市 ssbpmi SubSySESRTL 
Fe 双 ! iew 3muekon rzneg Inpds p 
口 | 区 加 本 | 下 | 可 二 | 盖 元 | ahoao [en 习 


丁丁 帮 TTI7TmzreT 





帮 eHimnpcmm 于 


Embedded simple 
logic operations 


nc_0006: Guidelines for mixed use of Simulink and 
Stafeflow 





e。 Ifthe primary nature of the function is logical, and some complicated 
numerical calculations must be done to Support the logic, use a 
Simulink subsystem to Implement the numerical calculations. The 
Stateflow software should invoke the execution of the subsystem， 
using a function cal]. 





各 《ton TIoog add Hep 


蕊 是 信守 到 认 [ 吕 作客 之 麻 iai 络 昌 “ 





UpFTbILinwtTrap 
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nca_0006: Guidelines for mixed use of Simulink and 
Stafeflow 





[callsLFromSF_Trams gr 
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nc_0006: Guidelines for mixed use of Simulink and 
Stafeflow 








上 naeoo6pant5 
Re to Far Iook bp 
六 坊 重 硬 罗 上 了 之 立 省 90 [es 可 芒 册 日 下 汉 | 且 | 


SLS FE Se 


PSaFyeorLr TENMUyFC 
《 SLSEC> 上 
LA 


二 


| 


1005 





e Use the Stateflow product to Implement modal logic，where the 
control function to be performed at the current time dqepends on a 
combination of past aa preset 1ogsical coPaQitioms. (Ifthere ls a need 
to store the result of a logical condition test in a Simulink model， 
for example, by storing a flag, this is an indicator of the presence of 
modal logic,， which shouldq be modeled with Stateflow software.) 
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nca_0006: Guidelines for mixed use of Simulink and 
Stafeflow 











Incorrecf 
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nc 0006: Guidelines for mixed use of Simulink and 
Stafeflow 





人 Jna0OObpart6JSF InpierneetOtior 二 


LARAD ucAC SHI 
ve 


HLRE snctornCa 
SoSeyztem 


和 


00 旬 











Correcf 


e Use Simulink to Implement numerical expressions containing 
continuously-valued states, Such as: difference equations, integrals， 
derivatives,， and 丘 ]ters. 
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nc_0006: Guidelines for mixed use of Simulink and 
Stafeflow 








Incorrecf 





Correcf 


Rafionale 。Readability 
e Workflow 
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nc_0006: Guidelines for mixed use of Simulink and 


Stafeflow 





Last 
Changed 


Model 
Advisor 
Check 


e Simulation 
e Verification and Validqation 


e (Code Generation 


V2.0 


Not applicable 
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nc_0007: Guidelines for use of Flow Charts, Truth Tables 
and State Machines 





ID: Tifle na_0007: Guidqelines for use of Flow Charts, Truth Tables and State 
Machines 

Priorify Strongly recommended 

Scope MAAB 

MATLAB All 

Versions 


Prerequisites ”na_0006: Guidelines for mixed use of Simulink and 
Statef1ow 


Descripfion Within Stateflow, the cholice of whether to use aflow chart or a state 
chart to model a given portion of the control algorithm functionality 
should be driven by the nature of the behavior being modeled. 


e Ifthe primary nature ofthe function segment is to calculate modes of 
operation or qiscrete-valued states, Use state charts. Some examples 
are: 


”了 Diagnostic models with pass, fail, abort, and conflict states 


” Model that calculates different modes of operation for a control 
algorithm 


e。 Ifthe primary nature of the function segment involves if-then-else 
statements, use flowcharts or truth tables. 


Specifics 


Ifthe primary nature of a function segment is to calculate modes or 
states, but if-then-else statements are requlred, add aflow chart to a 
state within the state chart. (See “Flowchart Patterns”on page 6-49.) 


Raftionale 。Readability 
e Workflow 
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na _0007: Guidelines for use of Flow Charts，Trufth 
Tables and Stafe Machines 





Last 
Changed 


Model 
Advisor 
Check 


e Slimulation 
e Verification and Validqation 


e (Code Generation 


V2.0 


Not applicable 
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nca_0007: Guidelines for use of Flow Charts, Truth Tables 
and State Machines 





Subsystem Hierarchies 


e db 0143: Similar block types on the model Levels 
e db 0144: Use of Subsystems 
e db 0040: Model hierarchy 
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db 0143: Similar block types on the model levels 





ID: Title 
Priorify 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


db_0143: Simillar block types on the model levels 
Strongly recommended 
NA-MAAB 


All 


None 


You must dqesign every level of a model with builqing blocks of the same 
type; only subsystems or only “Baslc Blocks”. 


Blocks that You Can Place at any Model Level 





Block Example 


Bus Creator 


Bus Selector 








mi 








三 


Data Store Memory 








Demux 


mn 





Enable (not on highest 
model leve]) 





上 
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db 0143: Similar block types on the model levels 





Blocks thaftf You Can Place af any Model Level (Continued) 


























Block Example 
From | 四》 
Goto IA] 
Ground 到 

I 
Inport 
Merge Msr9= 
Multiport Switch 引 
Mux | 
Outport 
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db 0143: Similar block types on the model levels 





Blocks thaft You Can Place at any Model Level (Continuedj) 





Block Example 


四 四 口 
Rate Translitlon 





Selector 





Switch 





Switch Case 





Terminator 





Trigger 





Type Converslion Convert 





Unit Delay 





了 时 





Raftionale 。Readability 
e Workflow 


e Verification and Validqation 
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db 0143: Similar block types on the model levels 





Lastf V2.1 

Changed 

Model By Task > Modeling Standardqds for MAAB > Simulink >“Check 
Advisor for mixing basic blocks andqd subsystems>” 

Check 
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db 0144: Use of Subsystems 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Raftionale 


Last 
Changed 


Model 
Advisor 
Check 


db_0144: Use of Subsystems 
Strongly recommended 
MAAB 


All 


None 


Group blocks in a Simulink qiagram together into subsystems based 
on functional qdecomposition of the algorithm, or portion thereof， 
represented in the diagram， 


Avoid grouping blocks into subsystems primarily for saving space 

in the diagram. 卫 ach subsystem in the diagram should represent &a 
unit of functionality required to accomplish the purpose of the model 
or Submodel. 

e Readability 

e。 Workflow 

e Verification and Validation 


e Code Generation 


V2.0 


Not applicable 
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db 0040: Model hierarchy 





ID: Tiftle 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Raftionale 


Last 
Changed 


Model 
Advisor 
Check 
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db_0040: Model hierarchy 
Strongly recommended 
MAAB 


All 


None 


The model hierarchy should correspond to the functional structure of 
the control System. 


e Readability 
e Workflow 
e Verification and Validqation 


e (Code Generation 


V2.0 


Not applicable 


db 0040: Model hierarchy 





J MAAB Model Architecture Decomposition 


e jc 0301: Controller mode1l 

e jc 0311: Top Layer/root 1Leve1l 
e jc 0321: Trigger Jayer 

e jc 0331: Structure Layer 

e jc 0341: Data flow Layer 
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ic 0301: Controller model 





ID: Title jc_0301: Controller model 
Priorify Mandatory 

Scope J-MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion Control models are organized using the following hierarchical structure. 
Detalls on each layer are provided in corresponding rules. 
e Top layer (root level), jc _ 0311: Top layer/root 1Leve1 
e Trigger layer, jc 0321: Trigger Layer 
e Structure layer. jc 0331: Structure 1Layer 
e Data flow layer, jc _ 0341: Data flow layer 
Use of the Trigger level is optional. In the following fgure, Type A 


shows the use of a trigger level while Type B shows a model without 
a trlgger level. 
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ic 0301: Controller model 





Rafionale 


Last 
Changed 


Model 
Advisor 
Check 


Contiroller Model 


Workflow 


V2.0 


Not applicable 
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ic 0311: Top layer/rooft level 





ID: Title jc_0311: Top layer/root level 
Priorify Mandatory 

Scope J-MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion Items to dqescribe in a top layer are as follows: 


e Overview: 了 xplanation of model feature overvViewW 
e Input: Input variables 


e Output: Output varliables 











一 一 一 一 一 一 一 一 只 


*- 一 一 一 一 Controller 及 
AN 


hput Dutpt 


Top Layer Example 


Rafionale Workflow 
Last V2.0 
Changed 
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ic_ 0311: Top layer/rooft level 





Model Not applicable 
Advisor 
Check 
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ic_0321: Trigger layer 
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ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Raftionale 


jc_0321: Trigger layer 
Mandatory 
J-MAAB 


All 


None 


Atrigger layer indicates the processing timing by using Triggered 
Subsystem or Function-Call Subsystem blocks, 


e The blocks should set Priority, ineeded. 


e The priority value must be displayed as a block annotation. You 
should be able to understand the priority-based order without having 


to open the blockK. 
(2 ) 
EventE 
国 


TimingA_function TimingB_function Task4ms_function Task2ms_function 
Priority= 1 Priority= 2 Priority = 3 Priority= 4 





Trigger Layer Example 


e Readability 
e Workflow 


e Code Generation 


ic_0321: Trigger layer 





Lasf V2.0 
Changed 

Model Not applicable 
Advisor 

Check 
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ic_ 0331: Siructure layer 





ID: Title jc_0331: Structure layer 
Priorify Mandatory 

Scope J-MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion e Describe a Structure l]ayer like the following structure layer example. 


”JIn the case of Type B, specify sample time at an Inport block or a 
Subsystem block to define task time of the subsystem. 


” JIn the case of Type B, use a block anpnotation at an Inport block 
or a Subsystem block and display sample time to clarify task time 
of the subsystem. 


e。 A subsystem of a structure layer should be an atomic subsystem. 


加 


Task2ms 





Component_F component_H 


Siructure Layer Example (Type A: No Descripftion of Processing Timing) 
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ic_ 0331: Siructure layer 





Raftionale 


Last 
Changed 


Model 
Advisor 
Check 









Input3 
<stsample=0.002> 


Component_K 
<tsamples-1> 





Input4 
<tsample=0.004> 













Component_l 
<tsample=-1> 





Local11 


Input4 
Local12 


component_ J component_L 
<tsampbles0.004> <tsample=0.002> 


Siructure Layer Example (Type B: Description of Processing Timing) 


e Readability 
e Workflow 


e Code Generation 


V2.0 


Not applicable 
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ic_0341: Data flow layer 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Raftionale 


Last 
Changed 


Model 


Advisor 
Check 
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jc_0341: Data flow layer 
Mandatory 
J-MAAB 


All 


None 


Describe a dqata flow layer as in the following example. In the case of 
Type A, use a block annotation at an Inport block and display its sampljle 
世 me to clarify execution timing ofthe signal. 


Unnecessaly display in TYPpeAa. 











(TIy7 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 佑 | 
一 上 oacall 一 有 
<ts ampbples0.002> 同 
性 大 Sublnput SubOutput 
Local2 






Subcomponent 







<tsample=0.002> 





Local3 cmap 
<tsample=0.002> 
Data Flow Layer Example 


Workflow 


V2.0 


Not applicable 





Model Confhguration 
Optlonsg 





人 引 NModel Configuration Optiions 





Model Configuration Options 


e jc 0011: Optimization parameters for Boolean data types 


e jc _ 0021: Model diagnostic settings 


ic_ 0011: 


Opftimizaftion Parameters for Boolean data 
fyPes 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Rafionale 


Last 
Changed 


Model 
Advisor 
Check 


jc_0011: Optimization parameters for Boolean dqata types 
Strongly recommended 

MAAB 

All 

na_0002: Appropriate ImplLementation of fundamental 1ogical 

and numerical operations 


The optimization option for Boolean dqata types must be enabled (on). 





MATLAB Version Option Name 





及 13SP2 and earlier Boolean Logic slgnals 





有 14 and later Use logilc signals as Boolean data. 


(versus double) 








e Workflow 


e (Code Generation 


V2.0 


By Task > Modeling Standards for MAAB > Simulink >“Check 
Implement logic signals as Boolean dqata (vs. dqouble)” 
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ic_ 0021: Model diagnostic settings 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


jc_0021: Model qiagnostic settings 
Strongly recommended 
MAAB 


All 


None 


The following diagnostics must be enabledq. An enabled diagnostic 

ls set to warning or error. Setting the qiagnostic option to none 1S8 
not permitted. Diagnostics that are not listed may be set to any value 
(none, warning, or erron). 


Solver Diagnostics 


e Algebralc loop 
e。 Minimlze algebralc loop 


Sample Time Diagnostics 


e Multitask rate translition 


Data Validity Diagnosfics 


e。 Infor NaN block output 
e Duplicate data store names 


Connecftivity 


e Unconnected block input ports 
e Unconnected block output ports 
e Unconnected line 


e Unspecified bus object at root Outport block 


ic_0021: Model diagnostic settings 





Raftionale 


Last 
Changed 


Model 
Advisor 
Check 


e Mux blocks used to create bus slgnals 
e Invalid function-call connection 


e Element name mlsmatch 


e Workflow 


e (Code Generation 


V2.0 


By Task > Modeling Standards for MAAB > Model Configuration 
Options > “Check model diagnostic parameters?” 
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ic_ 0021: Model diagnostic settings 





4-6 





SlmuUllnk 


ee “Diagram Appearance ”on page 5-2 
e “Signals” on page 5-30 

e “Block Usage” on page 5-38 

e “Block Parameters”on page 5-60 


e “Simulink Patterns” on page 5-67 


5 Simulink@ 





Diagram Appearance 


e na_ 0004: Simulink model appearance 

e db 0043: Simulink font and font Size 

e db 0042: Port block in Simulink models 

e na_ 0005: Port block name visibility in Simulink models 
e jc 0081: Icon display for Port block 

e jm_ 0002: Block resizing 

e db 0142: Position of bJock names 

e jc 0061: Display of block names 

e db 0146: Triggered，enab1led，conditional Subsystems 
e db 0140: Display of basic bJlock parameters 

ee jm_ 0013: Annotations 

e db 0032: Simulink signal appearance 

ee db 0141: Signal flow in Simulink models 


ee jc 0171: Maintaining Signal flow when Using Goto and From 
blJocks 


e jm 0010: Port block names in Simulink modeJls 


e jc 0281: Naming of Trigger Port block and Enable Port block 
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na_0004: Simulink model apPpearance 





ID: Title na_0004: Simulink model appearance 
Priorify Recommended 

Scope MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


The model appearance settings shouldq conform to the following 
guidelines when the model is released. You can change the settings 
during the qdqevelopment process. 


Descripfion 

















View Opftions Setting 
Model Browser Unchecked 
Screen color White 
Status Bar Checked 
Toolbar Checked 


Zoom factor 


Normal (1009%0) 
































Block Display Options Setting 
Background Color White 
Foreground Color Black 
Execution Context Indqicator Unchecked 
Library Link Display None 
Linearlization Indqicators Checked 
Model/Block LO Mismatch Unchecked 
Model Block Verslon Unchecked 
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na_0004: Simulink model apPpearance 












































Block Display Options Setting 
Sample Time Colors Unchecked 
Sorted Order Unchecked 
Signal Display Opiions Setting 
Port Data Types Unchecked 
Signal Dimenslions Unchecked 
Storage Class Unchecked 
Test polint Indqicators Checked 
Viewer Indicators Checked 
Wide Nonscalar Lines Checked 
Raftionale 。Readability 
e Workflow 
Lasf V2.0 
Changed 
Model By Task > Modeling Standards for MAAB > Simulink >“Check 
Advisor for Simulink qiagrams using nonstandard display attributes?” 
Check 
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db 0043: Simulink fontf and fontf size 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Raftionale 


Last 
Changed 


Model 
Advisor 
Check 


db_0043: Simulink font and font size 
Strongly recommended 
MAAB 


All 


None 


All text elements (block names, block annotations, and slgnal ljabels) 
except free text annotations within a model, must have the same font 
style and font size. Select font style and font size for legibility， 





Neofte The selected font shouldq be portable (for example, the Simulink 
and Stateflow default font) or convertible between platforms (for 
example, Arial or Helvetica 12pt). 





e Readability 
e Workflow 


V2.0 


By Task > Modeling Standardqds for MAAB > Simulink >“Check 
font formatting?” 
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db 0042: Porf block in Simulink models 





ID: Tiftle 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


db_0042: Port block in Simulink models 
Strongly recommended 
MAAB 


All 


None 


In a Simulink model, ports must comply with the following rules: 
e Place Inport blocks on the left side of the qiagram; you may move 
them to prevent slgnal crosslings. 


e Place Outport blocks on the right sidqe of the diagram; you may move 
them to prevent slgnal crossings. 


e You may use quplicate Inport blocks at the subsystem level, 让 
required, but avolid qdqoing so, 让 possible. 


”Do not use quplicate Inport blocks at the root level. 


db 0042: Porf block in Simulink models 








<VD2_Cal> 





SIIPCalc 








Correcf 





SlipCalc 








Incorrecf 


Notes on the incorrect model 


e Inport 2 should be moved in so it does not cross the feedback loop 
lines. 


e Outport 1 should be moved to the right side of the diagram. 


db 0042: Porf block in Simulink models 





Raftionale Readability 

Lastf V2.0 

Changed 

Model By Task > Modeling Standardqds for MAAB > Simulink >“Check 
Advisor positioning andq configuration of ports?” 

Check 
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na_0005: Port block name visibility in Simulink 


models 





ID: Tiftle 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


na_0005: Port block name visibllity In Simulink models 
Strongly recommended 
MAAB 


All 


None 


While for some items, it is not possible to define a single approach that 
may apply to all organlizations internal processes, lt ls Important that， 
at least within a given organizatlion, a Single conslstent approach 18 
followed. An organization applying the guidelines must enforce one of 
the following alternatives. 


Apply one of the following practices: 


e The name of an Inport or Outport block is not hidden. 
(ormat > Hiqe Name ls not allowed.) 







gRPM_LP 
ES9RPM_ILP Eee 
EngRPM_LP 





EngRPM_F 让 






<EngRPM_Fit> 


| EngRPM_Filt 
RPM Fi 量 

权 台 EngRPM_URFit EngRPM_UnF 刘 
EngRPM_UnFilt 





EnginsRPM_Filtsr 


e The name of an Inport or Outport block must be hidqdqen. 
(Format > Hiqde Name ls used.) 


卫 xception: The names cannot be hiddqden Inside library subsystem 
blocks. 
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na_0005: Port block name visibility in Simulink models 





Rafionale 


Last 
Changed 


Model 
Advisor 
Check 








EngRPFM_LP 


EngRPM_UnFik 






EnginesRPM_Filter 


Readability 


V2.0 


By Task > Modeling Standardqds for MAAB > Simulink >“Check 
visibility of block port names?” 


ic_0081: Icon display for Port block 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Rafionale 


Last 
Changed 


jc_0081: Icon qisplay for Port block 
Recommended 
MAAB 


R14 and later 


None 


The Icon qisplay setting should be set to Port number for Inport and 
Outport blocks. 


Correcft 
(_ 3.RPM 有 





(4EngsTS JE 人 4EneTS ) 
Incorrecf 


Readabillity 


V2.0 


ic_0081: Icon display for Port block 





Model By Task > Modeling Standards for MAAB > Simulink >“Check 
Advisor for unconnected ports and signal lines?” 
Check 


Im_0002: Block resizing 





ID: Title jm_0002: Block resizing 
Priorify Mandqatory 

Scope MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion All blocks in a model must be slzed such that the licon 1s completely 
visible and recognizable. In particular, any displayed text (for example， 
tunable parameters, file names, or equations) in the icon must be 
readable. 


This guldqeline requlres that you reslze blocks with variable lcons or 
blocks with a variable number of inputs and outputs. In some cases, 让 
may not be practical or desirable to resize the icon of a subsystem block 
so that all ofthe input and output names within it are readable. In such 
cases, you may hide the names in the lcon by using a mask or by hliding 
the names in the subsystem associated with the icon. If you do this， 
the signal lines coming into and out ofthe subsystem block should be 
clearly labeled in close proxlimailty to the block. 


[wn ble_Dararmeter_ Yalue | J L |eesrw 


Constant L_z*05 nput_5oma2 











Discrele 


Si NA Transfer Ftn 下 Po SN 
1000 一 > [50nall 六 | 
Galn Frommh SU wa 。 





In _3M5 





Data Type 
Cormversion Subsystem 


Correcf 
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im_0002: Block resizing 





回 
Constart 

中 | Discrete 

愉 > [en Transfer Fon 


Galn From 人 TI 


Dala Type 
Corwersion 





Incorrecf 
Raftionale Readability 
Lastf V2.0 
Changed 
Model Not applicable 
Advisor 
Check 
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db 0142: Posifion of block names 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Raftionale 


Last 
Changed 


Model 
Advisor 
Check 


db_0142: Position of block names 
Strongly recommended 
MAAB 


All 


None 


If shown, place the name of a block below the block. 


EngRPMRaw EngRPMF 灿 





EngSignal_LowPass 


Correcf 


TransSignsl_LowPasss 


TransRPMRazw TransRPMF 泪 





Incorrecf 


e Readability 
e Workflow 


V2.0 


By Task > Modeling Standards for MAAB > Simulink >“Check 
whether block names appear below blocks” 
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ic_0061: Display of block names 





ID: Tiftle 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Raftionale 


Last 
Changed 


Model 
Advisor 
Check 


jc _0061: Display of block names 
Recommended 
MAAB 


All 


None 


e。 Display a block name when it provides descriptive information. 


e Do not qisplay a block name if the block function is known and 
understood from the block appearance, 


Readabillity 


V2.0 


By Task > Modeling Standardqds for MAAB > Simulink >“Check 
the display attributes of block names?” 


db 0146: Triggered, enabled, conditional Subsystems 





ID: Tiftle 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Rafionale 


Last 
Changed 


Model 
Advisor 
Check 


db_0146: Triggered, enabled, conditional Subsystems 
Strongly recommended 
MAAB 


All 


None 


Place blocks that are insidqe of and define subsystems as conditional or 
iterative at a conslistent location at the top of the subsystem diagram. 
This applies to the following types of blocks: 


e。 Function call 
e Enabled 

e Triggered 

e If / 卫 l]se Action 


e Readability 
e Workflow 


e Verification and Validqation 


V2.0 


By Task > Modeling Standardqds for MAAB > Simulink >“Check 
for incorrect position of Trigger and Enable blocks” 
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db 0140: Display of basic block paramefters 





ID: Title db_0140: Display of baslic block parameters 
Priorify Recommended 

Scope MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion Ifthe block parameter meets all of the following condqitions, display t 
as a text annotation to the block: 
e Modified from the qefault setting. 
e Affects either the simulation or code generation behavior of a block. 
se。 Not automatically displayed as part of the block icon. 


e 有人 arely changes. 











Examples 

Block: Annotate | Rationale 

Paramefter Block 

Gain: Gain N The Gain parameter is visible in the 
block icon . 

Integrator: Show | N The Show State Port parameter 1S 

State Port Visible as a modification to the block. 

JIntegrator: The Initial condition parameter 

JInitial condqition affects the Simulation and/or code 
generation behavior. It 1s not Vislble 
in the block icon. 
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db 0140: Display of basic block paramefters 





Raftionale 


Last 
Changed 


Model 
Advisor 
Check 


Examples (Conftinued) 











Block: Annotate | Rationale 

Paramefter Block 

Sample Time Y/N Ithe sample time that you select 
matches the subsystem sample time， 
you do not need to display the rate 
information. 

Saturation: 和 N Annotating the block with the 


Upper Limit 








Saturation: Upper Limit value 
1s optional because the value will] 
change. 








Nofte You can use the attribute string to support the display of basic 
block parameters. Add the attribute information that you want using 
the block annotation tab， 





e Readability 


e Verification and Validqation 


V2.0 


By Task > Modeling Standardqds for MAAB > Simulink >“Check 
for nondefault block attributes?” 


5-19 


Im_0013: Annotations 





ID: Title jm_0013: Annotations 
Priorify Strongly recommended 
Scope MAAB 

MATLAB R12.1 

Versions 


Prerequisites ”None 


Descripfion Annotations should not have a drop shadow. (Format > Show Drop 
Shaqdow is not allowed.) 


Thisis a correct 


annotation 
Thisis an incorrect 
annotation 

Raftionale Readability 
Lastf V2.0 
Changed 
Model By Task > Modeling Standarqds for MAAB > Simulink >“Check 
Advisor for annotations with qrop shadows?” 
Check 
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db 0032: Simulink signal apPpearance 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


db_0032: Simulink signal appearance 
Strongly recommended 
MAAB 


All 


None 


Signal lnes 


e Should not cross each other, 让 possible 
e Are drawn with right angles 

e Are not drawn one Upon the other 

e Do not cross any blocks 


e Should not split into more than two sublines at a single branching 
point 





Terminator 


Censtant 





Terminato 挛 


Correcf 
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db 0032: Simulink signal apPearance 








Terminateo 之 


Incorrecf 
Raftionale 。Readability 
e Workflow 
Last V2.0 
Changed 
Model Not applicable 
Advisor 
Check 
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db 0141: Signal flow in Simulink models 





ID: Tifle 
Priority 
Scope 
Versions 
Prerequisites 


Description 


Rafionale 


db _0141: Signal flow in Simulink models 
Strongly recommended 

MAAB 

All 

None 


The signal fow in a model is 位 om left to right. 

卫 xception: Feedback loops 

Sequential blocks or subsystems are arranged from left to right. 
卫 xception: Feedback loops 


Parallel blocks or subsystems are arranged 他 om top to bottom. 


研 
[2 


9 
重 


TaoDmA1 
Wo | cuatcl |] 
ctd 


TDA3 


[ 


5 
pepD 
林 
eu 
5 
Ineap 
硬 柄 
eepF 
烙 了 ， 
Mew 
(3 
MewH 


e Readabillity 
e Workflow 
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db 0141: Signal flow in Simulink models 





e Verification and Validqation 


Lasft V2.0 
Changed 

Model Not applicable 
Advisor 

Check 
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ic 0171: Maintaining signal flow when using Gofto 


and From blocks 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


jc _0171: Maintaining signal flow when using Goto and From blocks 
Strongly recommended 
MAAB 


All 


None 
se。 You must maintain visual depiction of signal flow between 
SuUbsystems. 


e You can use Goto and From blocks provided that you use at least one 
slgnal ]line between connected subsystems. 


e Ifthe subsystems are connected in a feed-forward and feedqback loop， 
you must connect at least one Signal line for each direction. 





Correcf 
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ic 0171: Maintaining signal flow when using Goto and 
From blocks 




















4 全 
王 习 人 | CE 人 | 一 -< RS] 
估 ~ 各- ] 轴 人 | - 名 
-站 和 
[EC | 村 bg -- Fe 
PT Pet 和 | 舍 一 
CE -ED 
芭 -一 
基 ET 和 
4 有 人 | Fe < 
6 一 全 训 - < TSESTD 门 
Incorrecf 
@@ 1。 
Raftionale 。Readability 
e Workflow 


e Verification and Validqation 


Last V2.0 
Changed 

Model Not applicable 
Advisor 

Check 
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im_0010: Port block names in Simulink models 





ID: Tiftle 
Priorify 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


]m_0010: Port block names in Simulink models 


Strongly recommended 
MAAB 


All 


e db 0042: Port block in Simulink models 


e na_ 0005: Port block name Visibility in Simulink models 


For some items, though you may not be able to define a single approach 
for internal processes of all organizations, within a given organization， 
try to follow a single, consistent approach. An organization applying the 
guidqelines must enforce ome of the following options: 


eNames of Inport and Outport blocks must match 
corresponding signal or bus names. 


卫 xceptions: 


” When any combination of an Inport block, an Outport block, and 
any other block have the same block name, use a Suffix or prefix on 
the Inport and Outport blocks. 


” One common suffix / prefix js _in for Inport blocks and out for 
Outport blocks. 


”You may use any suffix or prefix on the ports, however, the prefix 
that you select must be conslstent. 


”Library blocks and reusable subsystems that encapsulate generic 
functionality. 


e。 When names of Inport and Outport blocks are hiddqden, apply a 
consistent naming practice for the blocks. Suggested practices 
include leaving the dqefault names (for example, 0ut1),giving them 
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im_0010: Port block names in Simulink models 
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Rafionale 


Last 
Changed 


Model 
Advisor 
Check 


the same name as the associated Signal, or gliving them a shortened 
or mangled version of the name of the associated signal. 


e Readability 
e Workflow 


e Slimulation 


V2.0 


By Task > Modeling Standardqds for MAAB > Simulink >“Check 
for matching port and signal names?” 


ic 0281: Naming of Trigger Port block and Enable 


Porf block 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Rafionale 


Last 
Changed 


Model 
Advisor 
Check 


jc _0281: Naming of Trigger Port block and Enable Port block 
Strongly recommended 
J-MAAB 


All 


None 


For Trigger and Enable port blocks, match the block name of the signal 
triggering the subsystem. 


口 区 园 红 
Task2ms 
Task2ms 
不 
ITO0% 
Readabillity 
V2.0 


By Task > Modeling Standardqds for MAAB > Simulink >“Check 
Trigger and Enable block names?” 
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Naming of Trigger Port block and Enable Port 
oOc 





Signals 
e na_ 0008: Display of labels on Signals 
e na_ 0009: Entry versus propagation of Signal Labels 
e db 0097: Position of labeJs for Signals and busses 
e db 0081: Unconnected Signals，block inputs and block 


outputs 


The preceding gulidelines apply to slgnals and slgnal labels，For 
background information, see“Signals and Signal Labels”on page D-3. 


Some of the preceding guidqelines refer to basic blocks，For an 


explanation of the meaning and some examples, see “Basic Blocks”on 
page D-2. 
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na_0008: Display of labels on signals 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


na_0008: Display of labels on signals 


Recommended 


MAAB 


All 


None 


e。 Alabel must be qisplayed on a signal originating 位 om the following 


blocks: 


e。 A label must be displayed on any signal connected to the following 
destination blocks (directly or by way of a basic block that performs 


JInport block 
From block (block lcon exception applies - see the Note below 
Data Store Read block (block icon exception applies) 


Subsystem block or Stateflow chart block (block icon exception 
applies) 


Constant block (block lcon exception applies) 

Bus Selector block (the tool forces this to happen) 
Demux block 

Selector block 


a nontransformative Operation): 


Outport block 

Goto block 

Data Store Write block 
Bus Creator block 
Mux block 

Subsystem block 
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na_0008: Display of labels on signals 





Raftionale 


Last 
Changed 


Model 


Advisor 
Check 
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” Chart block 





Nofte Block icon exception (applicable only where called out): 下 

the slgnal ljabel ls vislble in the originatimng block lcon qisplay, the 
connected slgnal does not need to have the label displayed, unless the 
slgnal ]abel ls needed elsewhere due to a destination-based rule. 





e。 In addition, a label may be qisplayed on any other signal of interest 
to you or yoOUT customers. 


CalVar_1 
CavVar-2 CalVar_2 


e Readability 
e Workflow 
e Verification and Validation 


e Code Generation 


V2.0 


By Task > Modeling Standardqds for MAAB > Simulink >“Check 
for proper labeling on signal lines?” 


na_0009: Entry versus propagaftion of signal labels 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


na_0009: Entry versus propagation of signal ljabels 
Strongly recommended 
MAAB 


All 


na_0008: Display of labels on Signals 


If a label is present on a signal, the following rules define whether that 
label is created there (entered directly on the signal) or propagated from 
its true Source (inherited 他 om elsewhere in the model by using the less 
than (<) charactem)， 


e。 Any displayed signal label must be eterea for signals that: 


” Originate 位 om an Inport at the Root (top) Level of a model 


” Originate from a basic block that performs a transformative 
operation (For the purpose of interpreting this rule only, the 
Bus Creator block, Mux block, and Selector block are consldered 
to be included among the blocks that perform transformative 
operations.) 


e。 Any displayed signal label must be propasatea for signals that: 
”Originate 位 om an Inport block in a nested subsystem 


Exception: If the nested subsystem is a library subsystem，a 
label may be entered on the signal coming 位 om the Inport to 
accommodate reuse of the library blockKk. 


”Originate from a basic block that performs a nontransformative 
Operation 


” Originate from a Subsystem or Stateflow chart block 
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na_0009: Entry versus propagation of signal labels 





Exception: Ifthe connection originates from the output of a library 
SUubsystem block instance, a new label may be entered on the 
signal to accommodate reuse of the library block. 














Raftionale 。Readability 
e Workflow 
e Verification and Validation 


e Code Generation 


Lasf+ V2.0 

Changed 

Model By Task > Modeling Standarqs for MAAB > Simulink >“Check 
Advisor for propagated signal l]abels?” 

Check 
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db 0097: Position of labels for signals and busses 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Rafionale 


Last 
Changed 


Model 
Advisor 
Check 


db_0097: Position of ljabels for signals and busses 
Strongly recommended 
MAAB 


All 


None 


The labels must be visually assoclated with the corresponding slgnal 
and not overlap other labels, signals, or blocks. 


Labels should be located conslstently below horizontal lnes and close to 
the corresponding source or destination blockK. 


e Readability 
e Workflow 


V2.0 


Not applicable 
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db 0081: Unconnected signals, block inpufts and block 
oufpPufs 





ID: Title db_0081: Unconnected Signals, block Inputs and block outputs 
Priorify Mandqatory 

Scope MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion A system must not have any: 


e Unconnected subsystem or baslc block Inputs 
e Unconnected subsystem or baslc block outputs 


e Unconnected slgnal lines 
In addqition: 


e An otherwise unconnected input should be connected to a ground 
block 


e An otherwilse unconnected output should be connected to a terminator 
block 


Raftionale 。Readability 
e Workflow 


e Verification and Validqation 


Last V2.0 
Changed 
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db 0081: Unconnected signals, block inpufts and block 





oufpPufts 
Model By Task > Modeling Standards for MAAB > Simulink >“Check 
Advisor for unconnected ports and signal ljines?” 
Check 
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db 0081: Unconnected signals, block inpufts and block 
oufpPufs 





Block Usage 


e na_0003: Simple 1ogical expressions in If Condition 
block 


e na_ 0002: Appropriate impLementation of fundamental 
1ogical and numerical operations 


e jm 0001: Prohibited Simulink standard blocks inside 
controllers 


e hd _ 0001: Prohibited Simulink Sinks 

e na _ 0011: Scope of Goto and From blocks 

ee jc 0141: Use of the Switch block 

e jc 0121: Use of the Sum bJock 

ee jc 0131: Use of Relational Operator block 

ee jc 0161: Use of Data Store Read/Write/Memory blocks 
Some of the preceding guidqelines refer to basic blocks， For an 


explanation of the meaning and some examples, see “Basic Blocks”on 
page D-2. 
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na_0003: Simple logical expressions in If Condition 


block 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


na_0003: Simple logical expressions in If Condition block 
Mandatory 
MAAB 


All 


None 


A logical expression may be Implemented within an If Condition block 
instead of building it up with logical operation blocks, ithe expression 
contains two or fewer primary expressions. A _ primary expression is 
defined as one of the following: 

e An Input 

e A constant 


e A constant parameter 


e A parentheslzed expresslon contalning no Operators eXcept Zero oO 
one instance of the following operators: < , <= , >, >=, ~=, ==, ~. (See 
the following examples.) 


Excepfion 


A logical expresslon may contain more than two primary expresslons 
让 both of the following are true: 


e The primary expresslongs are all Inputs 


e Only one type of logical operator is present 
Examples of Acceptable Exceptions 


e ul |u21u31u4105 
e UK u2R&u3K&u4 
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na_0003: Simple logical expressions in If Condition 
block 
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Raftionale 


Examples of Primary Expressions 


e U1 

e 5 

e 长 

e (uU1 > 0) 
e (ul1 <= O) 
e (ul1 > U2) 
。 (Cu1) 


Examples of Acceptable Logical Expressions 


e U1 | U2 

e (ul1>0)& (ul<20) 
e (ul1> 0) &(u2 < u3) 
e (uU1 > 0) && (~Uu2) 


Examples of Unacceptable Logical Expressions 





uU1 & u2 | u3 (too many primary expresslions) 





uU1 & (u2 | u3) (unacceptable operator within 
primary expresslon) 





(u1>0)& (ul1<20) &(u2>5) (too many primary expresslongs 
that are not inputs) 





(u1 > 0) & ((2*u2) > 6) (unacceptable operator within 
primary expresslon) 








e Readability 
e Workflow 


na_0003: Simple logical expressions in If Condition 


block 





Lasf V2.0 
Changed 

Model Not applicable 
Advisor 

Check 
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na_0002: Appropriate implementaftion of fundamental 
logical and numerical operaftions 





ID: Title na_0002: Appropriate implementation of fundqdamental logical and 
numerical operations 


Priorify Mandatory 
Scope MAAB 
NMATLAB All 
Versions 


Prerequisites ”None 


Descripfion e Blocks that are intended to perform numerical operations must not 
be used to perform logical operations. 





Incorrecf 


e。 Alogical output should never be connected directly to the input of 
blocks that operate on numerical inputs， 


e The result of a logical expression fragment should never be operated 
on by a numerlical operator. 
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na_0002: Appropriate implementaftion of fundamentadal 
logical and numerical operations 





Raftionale 


Last 
Changed 


Model 
Advisor 
Check 






Incorrecf 


e Blocks that are intended to perform logical operations must not be 


doubie 


used to perform numerical operations. 


e。 A numerical output should never be connected to the input of blocks 
that operate on loglcal Inputs. 





Incorrecf 


e Readabillity 
e Workflow 


V2.0 


Not applicabjle 


double 
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im_0001: Prohibited Simulink standard blocks inside 
controllers 





ID: Tifle ]m_0001: Prohibited Simulink standard blocks inslde controllers 
Priorify Mandqatory 

Scope MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion Controller models must be qesligned from qiscrete blocks. 


The following sources are Pot allowed: 


Signal 0000 
Generator 的 | 人 


日 
(CO 
心 


Step [| Diglital ClockK 

Ramp From File antiedmar 
AN From ru 

Sine Wave ER [TU 

Repeating 川 了 Random 人 | 

Sequence Number 

Discrete Pulse ee 岂 4 

Generator 9 
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im_0001: Prohibited Simulink standard blocks inside 
controllers 





Pujlse Band-Limited 岂 j 
Generator 山中 White Nolse 
Chirp Signal 

The following continuous blocks are Pot allowed: 


| 
Jntegrator SS 上 了 State-Space 








5 ， 1 
Derivative durdt Transfer Fcn 二 
是 
Transport \s-1 
了 Zero-Pole 下 
Delay sls+1) 


Variable 
Transport 
Delay 

The following addqitional blocks are not allowed. The MAAB Style guide 
group recommends not using the following blocks. The list may be 
extended by Individual companiles. 


Real-Imasg to Re 、 
1 
Slider Gain 踊 Ri Eee 
Algebraic Solve . 
Constraint f@) fz=0 “ 了 it Crossing 二 
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im_0001: Prohibited Simulink standard blocks inside 
controllers 





Minaaigwia wa Polynomial Fu 
且 . 凡 . VV- 5 OLYyHnO 妨 2 OP)= 5 


必 Interpreted 
Magnitude-Angle MATLAB Fcn 





Function 
Magnitude-Angle 省 Goto Tag 四 
to Complex z Visibility 
1 Pecu)F 
Complex to incu 计 E 0, Ts:Io 0], 5C:0, D-0 
Real-Imasg 
Raftionale 。Readability 
e Workflow 


e Code Generation 


Lastf V2.0 

Changed 

Model By Task > Modeling Standardqs for MAAB > Simulink >“Check 
Advisor for prohibited blocks in qiscrete controllers?” 

Check 
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hd 0001: Prohibited Simulink sinks 





ID: Tifle 
Priorify 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Raftionale 


Last 
Changed 


hdqd_0001: Prohibited Simulink sinks 
Strongly recommended 
MAAB 


All 


None 


Controller models must be qesigned from discrete blocks, 


The following sink blocks are of allowed: 


加 

又 Y 

Display = 
To File 


e Readability 
e Workflow 


V2.0 


To 
Workspace 


Stop 
Simulation 


Floating 
Scope 


口 
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hd 0001: Prohibited Simulink sinks 





Model By Task > Modeling Standardqs for MAAB > Simulink >“Check 
Advisor for prohibited sink blocks>” 
Check 
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nc_0011: Scope of Goto and From blocks 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Raftionale 


Last 
Changed 


Model 
Advisor 
Check 


na_0011: Scope of Goto and From blocks 
Strongly recommended 
MAAB 


All 


None 


For Signal fows, From and Goto blocks must use local scope. 





Note Control flow signals may use global scope. 


e Readability 
e Workflow 


e (Code Generation 


V2.0 


By Task > Modeling Standardqds for MAAB > Simulink >“Check 
scope of From and Goto blocks” 
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ic 0141: Use of the Switch block 
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ID: Tiftle 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


jc_ 0141: Use of the Switch block 
Strongly recommended 
MAAB 


All 


None 


e The switch condition, input 2, must be a Boolean value. 


e The block parameter，Criteria for passing first input, should be 
set to U2~=0. 


e The block parameter, Criteria for passing first input, must not be 
set to U2>thnresholo for R13 verslions of MATLAB. 


ic 0141: Use of the Switch block 








已] Function Block Parameters: Switch 妇 | 


Switch 
Pass through input 1 when input 2 satisfies the selected criterion: otherwilse. pass 
through input 3. The inputs are numbered top to bottom [or left to rightl. The input 1 
pass-through crlterla are input 2 greater than or equal. greater than. or not equal to 





the threshold The frst and third input ports are data ports. and the second Input port 
is the control port. 


Main | sana Data Types | 


Criterla for passing frrst input: | u2~=D0 过 | 


uU2>= Threshold 


Threshold: 





Correcf 








Main | SionalData Types | 


Eriteria for passingdirst npukt ju2 >= Threshold 
Threshold 
[2 


Incorrecf 
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ic 0141: Use of the Switch block 





Raftionale 。Readability 
e Workflow 
Lastf V2.0 
Changed 
Model By Task > Modeling Standardqds for MAAB > Simulink >“Check 
Advisor Use of Switch blocks” 
Check 
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ic 0121: Use of the Sum block 





ID: Title jc_0121: Use of the Sum block 
Priorify Recommended 

Scope MAAB 

NMATLAB All 

Versions 


Prerequisites ”None 


Desc ripfion Sum blocks should: 


e Use the rectangular” shape. 


e Be sized so that the Input slgnals dqo not overlap, 





Correcf 
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ic 0121: Use of the Sum block 








全 汪 上 上 工 上 上 江上 工 工 


Incorrecf 


You may use the round shape in feedqback loops. 


e There should be no more than three inputs. 
e Position the Inputs at 90,180,270 dqegrees. 


e Position the output at 0 degrees. 








Correcf 
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ic 0121: Use of the Sum block 








Incorrecf 


ic 0121: Use of the Sum block 





Raftionale Readability 
Last V2.0 
Changed 

Model Not applicable 
Advisor 

Check 
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ic 0131: Use of Relational Operaftor block 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Raftionale 


jc _0131: Use of Relational Operator block 
Recommended 
J-MAAB 


All 


None 


When the relational operator ls used to compare a Slgnal to a constant 
value, the constant Input should be the second (lower) Input slgnal. 





Incorrecf 


e Readability 


e (Code Generation 
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ic 0131: Use of Relational Operator block 





Lastf V2.0 

Changed 

Model By Task > Modeling Standardqs for MAAB > Simulink >“Check 
Advisor configuration of Relational Operator blocks?” 

Check 
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ic 0161: Use of Data Store Read/Writfe/Memory 


blocks 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Rafionale 


Last 
Changed 


Model 
Advisor 
Check 


jc_0161: Use of Data Store Read/Write/Memory blocks 
Strongly recommended 
J-MAAB 


All 


jc_0341: Data flow 1Layer 


Data Store Memory, Data Store Read, and Data Store Write blocks are 


e Prohibited in a data flow layer 


e。 Allowed between subsystems running at different rates 


e Readability 
e Workflow 


V2.0 


Not applicable 
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ic 0161: Use of Data Store Read/Writfe/Memeory blocks 





Block Paramefers 


ee db 0112: Indexing 
e na_ 0010: Grouping data flows into Signals 
ee db 0110: Tunable parameters in basic blocks 


Some of the preceding guidqelines refer to basic blocks， For an 
explanation of the meaning and some examples, see “Basic Blocks”on 


page D-2. 
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db 0112: Indexing 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


db_0112: Indqexing 
Strongly recommended 
MAAB 


All 


None 
One-based indexing [1, 2, 3,...] ls for: 


e。 MATLAB 


Workspace varliables and structures 
Local variables of functions written in MATLAB-codqe 
Global variables 


ee Simulink 


Signal vectors and matrices 

Parameter vectors and matrices 

S-function input and output signal vectors and matrices in 
MATLAB-code 

S-function parameter vectors and matrices in MATLAB-code 
S-function local variables in MATLAB-code 


Zero-based indexing [0, 1, 2, ...] is for: 


e Simulink 


S-function input and output signal vectors and matrices in C 
S-function input parameters in C 

S-function parameter vectors and matrices in C 

S-function local variables in C 


e Stateflow 


Input and output slgnal vectors and matrlces 
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db 0112: Indexing 
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Rafionale 


Last 
Changed 


Model 
Advisor 
Check 


Parameter vectors and matrices 
Local variables 
Custom variables and Structures In C 


e C code 
Local varlables and Structures 


Global varlables 


e Readability 
e Workflow 


e (Code Generation 


V2.1 


By Task > Modeling Standardqds for MAAB > Simulink >“Check 
for indexing in blocks?” 


na_0010: Grouping data flows into signals 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


na_0010: Grouping dqata flows into Signals 
Strongly recommended 
MAAB 


All 


None 


Vectors 


The individual scalar slgnals composing a vector must have common 
functionality, qata types, dimensions, and units,. The most common 
example of a vector signal is sensor or actuator dqata that is grouped into 
an array indexed by location. The output of a Mux block must always be 
a vector. The inputs to a Mux block must always be scalars. 


Busses 


Signals that dqo not meet criteria for use as a vector,， as previously 
described, must only be grouped into bus slgnals. Use Bus Selector 
blocks only with a bus slgnal Input; do not use them to extract scalar 
Signals 位 om vector Silgnals. 


Examples 


Some examples of vector signals include: 




















Vector type Size 

Row vector [1L nl] 

Column vector mm HH] 

Wheel speed vector [L Number of wheels] 
Cylinder vector [1 Number of cylindqers] 
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na_0010: 


Grouping data flows into signals 





Rafionale 


Last 
Changed 


Model 
Advisor 
Check 
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Vector type Size 
Position vector based on 2D [1 2] 
coordinates 





Position vector based on 3D [1L 3| 
coordinates 








Some examples of bus signals includqde: 





Bus type Elements 





Sensor Bus Eorce Vector [FEFx, FEy, Fz|] 





Position 





Wheel Speed Vector [0 0， 9 9. 


]r， 





Acceleration 





Pressure 





Controller Bus Sensor Bus 





Actuator Bus 





Serial Data Bus Coolant Temperature 





Engine Speed, Passenger Door Open 








e Readability 
e Workflow 


V2.0 


By Task > Modeling Standqdarqs for MAAB > Simulink >“Check 
for signal bus and Mux block usage” 


db 0110: Tunable paramefters in basic blocks 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Raftionale 


Last 
Changed 


db_0110: Tunable parameters in baslc blocks 
Strongly recommended 
MAAB 


All 


None 


To ensure that a parameter ls tunable, enter lt in the baslc block: 


e Without any expTresslon. 
e Without a data type conveTslon. 


e Without selection of rows or columns. 




















[ tunablie_parametler_Yalue | tunable_pararnmeter_yector [ 贡 Unable_pararmeter_arrar 
Correct 

| tunable_jarfarnmeler_Y3AUB"2 } Wnable_pararnmetor_ yecior"3 } tumable ararme4er_arra 了 

| Ine16wunablie Parameter valu6) } tondable Dararneter Vector 上 tonable ararneer ara1 1) } 
Incorrect 


e Readability 
e Workflow 


e (Code Generation 


V2.0 
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db 0110: Tunable parameters in basic blocks 





Model By Task > Modeling Standardqs for MAAB > Simulink >“Check 
Advisor use oftunable parameters in blocks” 
Check 


5-66 


db 0110: Tunable Parameters in basic blocks 





Simulink Paftferns 


e na _ 0012: Use of Switch vs If-Then-E1LSsSe Action 
Subsystem 


ee db 0114: Simulink patterns for If-then-else-if 
constructs 


ee db 0115: Simulink patterns for case constructs 


ee db 0116: Simulink patterns for 1ogical constructs With 
1ogical bJocks 


ee db 0117: Simulink patterns for vector Signals 

e jc 0351: Methods of initialization 

ee jc 0111: Direction of Subsystenm 

The preceding guidelines illustrate sample patterns used in Simulink 


diagrams, As such, the patterns normally would be part of a much 
larger Simulink diagram. 


Some of the preceding guidqelines refer to basic blocks， For an 


explanation of the meaning and some examples, see “Basic Blocks”on 
page D-2. 
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na 0012: Use of Switch vs。If-Then-Else Acfion 


Sub 


5Yystfem 
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ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


na_0012: Use of Switch vs. If-Then-Else Action Subsystem 
Strongly recommended 
MAAB 


All 


None 


The Switch block should be used for modeling simple 矿 iPe7m-else 
Structures, ifthe assocliated inem and else actions involve only the 
asslignment of constant values. 


IF_Wwalue 
boolean 


IF_Condition 
Else_walue 


The 让 then-else action Subsystem construct: 







double 






double 






e Should be used for modeling 矿 如 em-else Structures, ithe associated 
iAemn and/or else actiongs requlre complicated computations. This 
maximizes Simulation efficiency and the efficiency of generated code. 
(Note that even a basic block, for example a table lookup, may requlre 
fairly complicated computations.) 


nc_ 0012: Use of Switch vs。If-Then-Else Acftion 


Subsystem 





Raftionale 


Last 
Changed 


Model 
Advisor 
Check 







DynamicSlipFlag 






WheelSpeed else { | 
EngSpeed 





CalculateTireSlip 


e Must be used for modeling 矿 专 en-else structures, ifthe purpose of 
the construct ls to avold an undesirable numerical computation,， such 
as divlslon by zero. 


e Should be used for modeling 矿 专 en-else Structures, 让 the explicit or 
Implied ipem or the else action ls just to hold the assoclated output 
Values. 


In other cases, the degree of complexity of the 如 em and/or else action 


computations and the intelligence ofthe Simulink simulation and code 
generation englines determine the appropriate construct. 


These statements also apply to more complicated nested and cascaded 
矿 妨 en-else structures and case Structure implementations, 


e Readability 
e Workflow 


V2.0 


Not applicable 
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db 0114: Simulink paftterns for If-then-else-if construcfts 





ID: Tifle db_0114: Simulink patterns for If-then-else-if constructs 
Priorify Strongly recommended 

Scope MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion Use the following patterns for If-then-else-if constructs within a 


Simulink model: 





Equivalent Functionality 


Simulink Pattern 





if then else if with blocks 


if (If_Condition) { 

output_ signal = If _ Value; 

) 

else if (Else_ If Condition) 1{ 
output_signal = 

EJSse_If Value 

) 

else 1{ 

output_signal = 

E1Sse_Value ; 


) 
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IL_Value 











Elise_if_ Valve 











db 0114: Simulink Patterns for If-then-else-if 


COnsfrucfs 








Equivalent Functionality 


Simulink Pattern 





if then else if with iffthen/else 
SUbsystems 


If(Fault 1 Active & 
Fault 2 _Active) 
{ 

ErrMsg = SaftyCrit ; 
】} 
else if (Fault 1_ Active | 
Fault 2 Active) 








{ 
ErrMsg = DriveWarn ; 
】} 
el1se 
{ 
ErrMsg = NoFau]lts ; 
} 
Raftionale 。Readability 
e Workflow 
e Code Generation 
Lasf V2.0 
Changed 
Model Not applicable 
Advisor 
Check 
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db 0115: Simulink patterns for case construcfs 





ID: Title db_0115: Simulink patterns for case constructs 
Priorify Strongly recommended 

Scope MAAB 

MATLAB All 

Versions 


Prerequisites ”None 











Descripfion Use the following patterns for case constructs within a Simulink model: 

Equivalentf Functionality Simulink Pattern 

case with Switch Case block 

switch (PRNDL_Enum) ed 

{ 一 

case 1 届 
TqESstimate = ParkV 人 
break ; 

case 2 L_ 
TqEstimae = RevV 
break ; 

default 
TqEstimate = NeutralV 
break ; 
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db 0115: Simulink paftterns for case construcfs 








Equivalent Functionality Simulink Pattern 





} 





case with subsystems 


output_version1 = 
function_ version1(input Signal) ; - 一 一 一 和 
output_version2 = 

function_ version2(input_ signal) ; 
output_version3 = 

function_ version3(input signal) ; 
output_version4 = 

function_ version4(input_ signal) ; 
SWitch (Selection) { | 和 
case 1: 0 
output_signal = output_ version1 ; 
break ; 

Case 2: | 国 ZTmRTTT 
output_ signal = output_version2 ; 
break ; 

Case 3: 

output_ signal = output_version3 
break ; 

Case 4: 

output_ signal = output_version4; 


} 
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db 0115: Simulink patterns for case construcfs 








Equivalent Functionality Simulink Pattern 





case with enabled subsystems 


SWitch (Selection) 1{ 
Case 1: se 有 
output_version1 = 
function_ version1(input_ signal) ; 
output_signal = output_version1 ; 
break ; 

Case 2: 

output_version2 = 

function_ version2(input Signal) ; 
output_signal = output_version2 ; 
break ; 

case 3: 

output_version3 = 

function_ version3(input_ signal) ; 
output_signal = output_version3 ; 
break ; 

default : 

output_version4 = 

function_ version4(input_ signal) ; 
output_signal = output_version4; 


章 章 


| | 
R | 重 富 < | YY | 生 间 上 
下 











Raftionale 。Readability 

e Workflow 

e Verification and Validation 
Lasf V2.0 
Changed 
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db 0115: Simulink paftterns for case construcfs 





Model Not applicable 
Advisor 
Check 
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db 0116: Simulink patterns for logical constructs with 
logical blocks 





ID: Title db_0116: Simulink patterns for logical constructs with logical blocks 
Priorify Strongly recommended 

Scope MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion Use the following patterns for logical combinations within Simulink: 
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db 0116: Simulink paftterns for logical constructs with 
logical blocks 








Equivalent Funcfionality Simulink Pattern 





Combination of logical signals: 
conjunctive 











input_sSignalt 





input_signal2 





input_signal3 






input_sSignal4 


0ut 凡 _5Signal 
input_Signa 司 





input_signal6 





input_signal7 





input_signal8 





Combination of logical Signals: 
disjunctive 












input_siOmalt 





input_SsiOnmal2 





input_SsiOmal3 








input_Ssional4 


Output_signal 
input_sinmal5 





input_SsioOmal6 





input_Ss 间 mal7 





inputL_SsiOnmal8 








Raftionale 。Readability 
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db 0116: Simulink patterns for logical constructs with 
logical blocks 





e Workflow 


e Verification and Validqation 


Last V1.0 
Changed 

Model Not applicable 
Advisor 

Check 
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db 0117: Simulink patterns for vector signals 





ID: Title db_0117: Simulink patterns for vector Signals 
Priorify Strongly recommended 

Scope MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion Use the following patterns for vector signals within a Simulink model: 





Equivalent Functionality Simulink Pattern 





Vector loop 


for (i=0; Re 
I>input_vector sizej I++) 一 和 
{ 
output_vector(I) = 
input_ Vector(I) * 
tunab1le_parameter _ value 


} 
Vector loop 


for (二 =0; Se 
i>input_vector _ size; i++) De 

{ 

output_vector(I) = 

input_ Vector(I) * 
tunab1le_parameter vector(I) ; 


} 
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db 0117: Simulink patterns for vector signals 








Equivalent Functionality Simulink Pattern 





Vector loop 


output_ signal = 1; 员 

for (=0; input_wector Duthbut_signal 
1I>input_Vvector_ Sizej i++) Product 

{ 


output_ signal = 
Output Signal * 
input_vector(I) ; 





} 

Vector loop 

output_signal = 1; 思 由 

for (1=0; input_wector JI | output_signal 
1I>input_ vector Sizej I++) Produrct 

{ 


output_signal = 
output signal / 
input_vector(I) ; 


} 


Vector loop 












TO (0 inpul vector 
_VYeE 
I>input_Vvector_ Sizej I++) 

ss 0ut 妇 ut_vector 
{ tunable_parameler_ value 









output_vector(I) = 
input vector(I) + 
tunab1le_parameter _ value 


} 


Constant 








5-80 


db 0117: Simulink patterns for vector signals 








Equivalent Functionality Simulink Pattern 





Vector loop 


for (II=0 | 
I>input_Vvector_ Sizej I++) 
{ tunable_parameler_Yvector + 
output_vector(I) = Constant 
input_Vvector(I) + 
tunab1le_parameter_ vector(I) ; 


} 





input Yector 





Output_ vector 





Sum 





Vector loop: 


output_ signal = 0; 


Tora=G 及 - 
i>input vector_size; i++) input_wector output_signa 


{ Sum 
output_ signal = 
output_ signal + 
Input_vector(I) ; 


} 





Vector loop: 


output_ signal = 0; 


for (二 =0; -》 
i>input_vector size; i++) input_wector output_signa 


{ Sum 
output_signal = 
output_ signal - 
input_vector(I) ; 


} 
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db 0117: Simulink patterns for vector signals 








Equivalent Functionality Simulink Pattern 





Minimum or maximum of a signal or a 


Vector over time: Ta 
imp 丰 li Sm 八 六 上 
QuUilpuA_ SIOnal_rin 
美 


inMal 












mpul vector FPmax 
Du 各 UL_yector_mmax 
MainMax 
Un _ Delsy 
Change event of a signal or a vector: 
T 串 | 
| 二 
[3 人 和 














Raftionale Readability 


Workflow 


Verification and Validation 


Code Generation 
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db 0117: Simulink patterns for vector signals 





Last V1.0 
Changed 

Model Not applicable 
Advisor 

Check 
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ic 0351: Methods of inifialization 





5-84 


ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


jc 0351: Methods of initialization 
Recommended 
MAAB 


All 


db 0140: Display of basic block parameters 
Simple Initializafion 


se Blocks such as Unit Delay, which have an initial value field, can be 
used to set simple Initial values, 


e To determine ithe initial value needs to be displayedq, see MAAB 
Gulideline db 0140: Display of basic block parameters. 






Dut1 
《initial=D> 


Unit Delay 
<initial=D> 


Example 


Inifializafion thaftf Requires Computaftion 


The following rules apply for complex initialization: 


e The initialization should be performed in a separate Subsystem. 


e The initialization subsystem should have aname that indlicates that 
initialization is performed by the subsystem. 


ic 0351: Methods of initializafion 





Raftionale 


Last 
Changed 


Model 
Advisor 
Check 


Complex initialization may be done at a local level (Example A), at a 
global level (Example B), or a combination of local and global. 









Example A 
《1 (C2 盖 
Initialize EventEB 
不 





Initialize_function TimingB_function Task4ms_function 
Priority = 1 Priority = 2 Priority= 3 
Example B 


Workflow 


V2.0 


Not applicable 
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ic 0111: Direcftion of Subsystem 





ID: Title jc_0111: Direction of Subsystem 
Priorify Strongly recommended 

Scope J-MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion Subsystem must not be reversed. 






Subsyvstem 


Unit DelsaVv 


Correcf 


it Del 
Subsyvsterml 


Incorrecf 
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ic 0111: Direction of Subsystem 





Rafionale 


Last 
Changed 


Model 
Advisor 
Check 


Readabillity 


V2.0 


By Task > Modeling Standardqds for MAAB > Simulink >“Check 
orientation ofSubsystem blocks?” 
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ic 0111: Direcftion of Subsystem 





5-88 





Stateflow 


ee “Chart Appearance” on page 6-2 

ee “Stateflow Data and Operations”on page 6-20 
e “Events”on page 6-39 

e “Statechart Patterns” on page 6-43 

e “Flowchart Patterns” on page 6-49 


O Stateflow@e 
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Chart Appearance 


。 db 0123: 
。 db 0129: 
。 db 0137: 
。 db 0133: 
。 db 0132: 
。 jc_0501: 
。jc_0511: 
。 jc_0531: 
。 jc_0521: 


Statef1low port names 

StatefJlow transition appearance 

States in state machines 

Use of patterns for Fl1owcharts 

Transitions in Flowcharts 

Format of entries in a State bJlock 

Setting the return value from a graphical function 
PLacement of the default transition 


Use of the return value from graphical functions 


db 0123: Stateflow port names 





ID: Title db_0123: Stateflow port names 
Priorify Strongly recommended 
Scope MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion The name of a Stateflow input or output should be the same as the 
corresponding slgnal. 


卫 xception: Reusable Stateflow blocks may have different port names. 


Raftionale 。Readability 

e Workflow 
Lasf V1.0 
Changed 
Model By Task > Modeling Standardqs for MAAB > Stateflow >“Check 
Advisor for mismatches between names of Stateflow ports and 
Check associated signals>” 
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db 0129: Stateflow transition apPpearance 





ID: Tiftle 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


db_0129: Stateflow transition appearance 
Strongly recommended 
MAAB 


All 


None 


Transitions in Stateflow: 


e Do not cross each other, ipossible 
e Are not drawn one Upon the other 
e Do not cross any states, ]unctions, or text 皇 elqs 


e Are allowed iftransition is to an internal state 


Translition labels may be visually assoclated to the corresponding 
translitlon. 


db 0129: Stateflow transifion appearance 









[condition] 


[condition] 
action1: action1: 


CU C>( 
{ { 
action2: 
(On CU 
罗 


Correcf 


KW_ 1 





| DuterSta4e/ 


InnerState/ 


db 0129: Stateflow transition apPpearance 








Incorrecft 
Raftionale 。Readability 
e Workflow 
Lasf V2.0 
Changed 
Model Not applicable 
Advisor 
Check 
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一 一 () 
[condition1] 国人 
__ 一 下 ondition2] State- 





sa 


db 0137: Stiafes in statfe machines 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Raftionale 


Last 
Changed 


Model 
Advisor 
Check 


db_0137: States in state machines 
Mandatory 
MAAB 


All 


db 0149: Flowchart patterns for condition actions 


In state machines: 


e At least two excluslve states exXlst. 

e Astate cannot have only one substate. 

e The initial state of a hierarchical level with exclusive states is clearly 
defined by a default transition. 

e Readability 

e Workflow 


e Verification and Validqation 


V2.0 


By Task > Modeling Standardqds for MAAB > Sstateflow >“Check 
for exclusive and qefault states and substate correctnesSs?” 


db 0133: Use of paftterns for Flowcharts 





ID: Title db_0133: Use of patterns for Flowcharts 
Priorify Strongly recommended 

Scope MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion A Flowchart is built with the help of Flowchart patterns (for example， 
if-then-else, for loop, and so on): 


e The dqata flow is oriented 他 om the top to the bottom.。 


e Patterns are connected with empty transitions. 


Raftionale 。Readability 
e Workflow 


e Verification and Validqation 


Lasf V1.0 
Changed 

Model Not applicable 
Advisor 

Check 
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db 0132: Transitions in Flowcharfts 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


db _0132: Translitions In Flowcharts 
Strongly recommended 
MAAB 


All 


None 


The following rules apply to transitions in Flowcharts: 


e Conditions are drawn on the horlzontal. 


e Actions are drawn on the vertical. 
e Loop constructs are intentional exceptions to thls rujle. 


e Transltions have a condition，a _ condition action,，or an empty 
transltlon. 


[condition] 


Transition with Condition 


actlion 


Transition with Condition Acfion 


db 0132: Transitions in Flowcharfts 





6-10 


Empty Transifion 


Transition actions are not used in Elowcharts. Transition actions are 
only valid when used in trangslitions between states in a state machine， 
otherwise they are not activated because of the inherent qdependency on 
avalid state to state translition to activate them.， 


jaction 
Transition Acfion 


At every junction, except for the last junction of a flow diagram, exactly 
one unconditional translition begins. Every decislon point unction) 
must have a default path. 


chon- 


“站 一 一 


| [condition] 
ea 湖 


人 人) 


S- 


db 0132: Transitions in Flowcharfts 





Raftionale 


Last 
Changed 


Model 
Advisor 
Check 


产 comrmme[ 信 所 


CC》 [人 ) 


F 闫 Comime[ 臣 世 


[conditon] 


commenty 
{ 
acbon 
} 
是 


Transitions with Comments 


e Readability 
e Workflow 


e Verification and Validqation 


V2.0 


By Task > Modeling Standardqds for MAAB > Stateflow >“Check 
Transition orientations in 人 lowcharts” 


ic 0501: Format of entries in aq Stafte block 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


jc _0501: Format of entries in a State block 
Recommended 
MAAB 


All 


None 
A new line should be: 


e Started after the entry (en), quring (du, and exit (ex) statements. 


e Started after the completion of an assignment statement “;”. 


》 


State 
enm: 
entry_value=1: 
durimg_value=0: 
du: 





entry_value= 必 : 
during_value=1 ; 
eX: 
exlIt_value=1: 


Correcf 


ic_0501: Format of entries in aq State block 





State 
en':entry_value=1] : 
during_ value=0: 


du:entry_value=0: 
durimg _ value=1: 
ex:exIt_value=2: 





Incorrecf 


Failed to start a new line after en, du, and ex. 


State 
en:entry value=l:during_value=0:du:entry_ value=0; 
during value=1:ex:exit value=2: 






Incorrecf 


Failed to start a new line after the completion of an assignment 


statement“;”. 
Raftionale Readability 
Lasf V2.0 
Changed 
Model By Task > Modeling Standardqs for MAAB > Stateflow >“Check 
Advisor entry formatting in State blocks in Stateflow charts?” 
Check 
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ic 0511: Setting the retfurn value from a graphical 
funcfion 





ID: Title jc _0511: Setting the return value from a graphical function 
Priorify Mandatory 

Scope J-MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion The return value from a graphical function must be set in only one place. 


fmeotbov AsF(B.C) 
音 


人] [C==0] 


Correcf 


Return value A is set in one place. 


ic 0511: Setting tfhe return value from a graphicadl 


funcftion 





Rafionale 


Last 
Changed 


Model 
Advisor 
Check 





| Arctior A=F(B.C) 
| 埋 


[B==0] 和 [C==0] 





Incorrecf 


Return value A ls set in multiple places. 


e Workflow 


e (Code Generation 


V2.0 


By Task > Modeling Standardqs for MAAB > Stateflow >“Check 
return value assignments of graphical functions in Stateflow 
charts?” 
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ic 0531: Placement of the default transition 





ID: Title jc _0531: Placement of the default transition 
Priorify Recommended 

Scope J-MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion e。 Default transition 1s connected at the top of the state. 


e The qdqestination state of the qefault transition is put above the other 
states in the same hlierarchy. 


State1 们 


SubSt of 
en 
Yirmer=0; 


di 
timer+=dT; 


timmer+=dT: 


Correcf 


e The dqefault transition is connected at the top of the state. 


e The qdqestination state of the qefault transition is put above the other 
states in the same hlierarchy. 
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ic_ 0531: Placement of the default transition 





Raftionale 


Last 
Changed 


Model 
Advisor 
Check 


Steate1 


Incorrecf 


e。 Default transition is connected at the slide of the state (State 1)， 


e The destination state of the default trangsition ls ]ower than the other 
states in the same hierarchy (SubSt_off). 


Readabillity 
V2.0 


By Task > Modeling Standardqs for MAAB > Stateflow > “Check 
default transition placement in Stateflow charts?” 
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ic_0521: Use of the return value from graphical 
functions 





ID: Title jc 0521: Use of the retuzrn value 位 om graphical functions 
Priorify Recommended 

Scope J-MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion The return value from a graphical function should not be used directly 
in a comparlison Operation， 


The datatype ofthe yariable in tihe 
辽 。 comparison operation is Clear 


0 一 一 


训 8 效 = temp testO) 


An intermediate variable is used in the conditional expression after 
the assignment of the return value fom the function temp_test to 
the intermediate varliable a. 








Correcf 
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ic _ 0521: Use of the return value from graphical 


funcfions 





Raftionale 


Last 
Changed 


Model 
Advisor 
Check 





馈 了 六 ! = temp testO 


Incorrecf 


Return value of the function temp_test is used in the conditional 
expresslon . 


Readabillity 
V2.0 
By Task > Modeling Standardqs for MAAB > Stateflow >“Check 


usage of return values from a graphical function in Stateflow 
charts” 
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ic_0521: Use of the return value from graphical 


funcftions 





6-20 


Stateflow Data and Operations 


na_0001: Bitwise Stateflow operators 


jc_ 0451: Use of unary minus on unsigned integers in 
Statef]low 


na_0013: Comparison operation in Statef1ow 


db 0122: StatefJlow and Simulink interface Signals and 
parameters 


db 0125: Scope of internal Signals and local auxiliary 
variables 


jc_ 0481: Use of hard equality comparisons for floating 
point numbers in Statef1ow 


jc_0491: Reuse of variables Within a SingJle Statef1low 
Scope 


jc_ 0541: Use of tunable parameters in Statef1ow 
db 0127: MATLAB commands in Statef1ow 
jm_0011: Pointers in Statef1Low 


na_0001: Bitwise Stateflow operaftors 





ID: Title 
Priorify 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Rafionale 


Last 
Changed 


Model 
Advisor 
Check 


na_0001: Bitwise Stateflow operators 
Strongly recommended 
MAAB 


All 


None 


The bitwise Stateflow operators (&,， | , and ^) shouldq not be used in 
Stateflow charts unless you want bitwise operations， 


To enable blitwilse operations， 
1 Select File > Chart Properties . 
2 Select Enable C-bit operations. 


Correcf 
Use && and | | for Boolean operation. 


Use& and | for bit operation. 


Incorrecf 


Use & and | for Boolean operation. 


e Slimulation 


e (Code Generation 


V2.0 


By Task > Modeling Standardqs for MAAB > Stateflow >“Check 
for bitwise operations in Stateflow charts?” 
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ic_ 0451: Use of unary minus on unsigned integers in 
Stateflow 





ID: Title 


jc_0451: Use of unary minus on unsigned integers in Stateflow 





Priorify Recommended 
Scope MAAB 
MATLAB Al 
Versions 
Prerequisites ”None 
Descripfion Do not perform unary minus on unsigned integers. 
业 Name Data Type 
si16_var1=-si16_var2; 后 swvs2 nn6 
1 
Correcf 
Name “| Data Type 
ui16_var1=-ui16_var2; | wwvsz un6 
1 
Incorrecf 
Raftionale 。Readability 
e Workflow 
e Code Generation 
Lasf V2.0 
Changed 
Model By Task > Modeling Standardqs for MAAB > Stateflow >“Check 
Advisor for unary minus operations on unsigned integers in Stateflow 
Check charts?” 
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na_0013: Comparison operation in Stateflow 





ID: Tifle 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


na_0013: Comparison operation in Stateflow 
Recommended 
MAAB 


All 


None 
e Comparisons should be made only between variables of the same 
data type, 


e If comparisons are made between variables of qifferent qata types， 
the variables need to be explicitly type cast to matching dqata types. 


、L[L<nj 要 





Correcf 


Same data type in 1 and mn” 


、[Kdl 
[Ta [ass 





Incorrecf 


Different data type in and “qd” 
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na_0013: Comparison operation in Stafteflow 








Correcf 


Do not make comparisons between unsigned integers and negative 
numbers. 


[K=-1 可 ( 
而后 二 辣 攻 SO 


[ 河 ， uint8 
Incorrecf 


Rafionale e。 Workflow 


e Code Generation 


Last V2.1 

Changed 

Model By Task > Modeling Standardqs for MAAB > Stateflow >“Check 
Advisor for comparison operations in Stateflow charts?” 

Check 
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db 0122: Stateflow and Simulink interface signals 


and parameters 





ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Raftionale 


Last 
Changed 


Model 
Advisor 
Check 


db_0122: Stateflow and Simulink interface signals and parameters 
Strongly recommended 
MAAB 


All 


None 


A Chart uses strong data typing with Simulink and requlres that you 
select the Use Strong Data Typing with Simulink IO parameter. 


e Readability 
e Workflow 


e Verification and Validqation 


V2.0 


By Task > Modeling Standardqs for MAAB > Stateflow >“Check 
for Strong Data Typing with Simulink IO” 


6-25 


db 0125: Scope of internal signals and local auxiliary 
variables 
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ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


db_0125: Scope of internal signals and local auxiliary variables 
Strongly recommended 
MAAB 


All 


None 


Internal signals and local auxiliary variables are "Local data" in 
Stateflow: 


e All local qata of a Stateflow block must be dqefined on the chart level 
or below the Object Hierarchy. 


e No local varlables may exist on the machine level (that 18，no 
interaction Should occur between local qata in different charts). 


ee Parameters and constants are allowed at the machine level]. 


Explornmg modelychart itate [olx| 
多 刺 Iobs 辣 kb 





0Objed Hierarchy Contefls of (State) modetchart St3 地 






Name  Scope Trigger Type See Min Max Inval FIWS ToWS Watch 
国 data Local double 0 





RentstD) dataf1)targets 攀 用 汗 


Correcf 


db 0125: Scope of internal signals and local auxiliary 





Rafionale 


Last 
Changed 


Model 
Advisor 
Check 








@@ 
variables 
Exzplonng .model -|Dx| 
Fe 了 5 Ioos 8 Hep 
objedHierary Conterts of (mathine) model 
Name  Scope Trigger Type Size Min Max Inival FWS ToWS Watch 





国 sata Local double 0 
区 ) State @ sun 
| 》 
rents(D) data( 人 ) argets 人 2 半 直 
Incorrecf 


e Readability 
e Workflow 


e Verification and Validqation 


V2.0 


By Task > Modeling Standardqds for MAAB > Stateflow > “Check 
for Strong Data Typing with Simulink I/O?” 
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ic 0481: Use of hard equality comparisons for floating 
point numbers in Stateflow 





ID: Title jc_0481: Use of hard equality comparisons for floating point numbers 
in Stateflow 

Priorify Recommended 

Scope MAAB 

MATLAB Al 

Versions 


Prerequisites ”None 
Descripfion e Do not use hard equality comparlsons (Var1 == Var2) with two 
floating-point numbers. 


e。 Ifahard comparison is required, a margin of error should be defined 
and used in the comparison (LIMIT, in the example). 


e 于 ard edquality comparisons may be done between two integer data 
types. 







[加 由 double 
[ 习 岂 double 








Correcf 
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ic_ 0481: Use of hard equality comparisons for floating 
point numbers in Stateflow 











Incorrecf 


Raftionale e。 Workflow 


e Verification and Validqation 


e Code Generation 


Lasf V2.0 
Changed 

Model By Task > Modqdeling Standqarqs for MAAB > Stateflow >“Check 
Advisor for equality operations between floating-point expressions in 
Check Stateflow charts” 
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scope 
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ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


jc_0491: Reuse of variables within a single Stateflow scope 
Recommended 
MAAB 


All 


None 


The same variable should not have multitple meanings (usages) within 
a single Stateflow scope. 


Correcf 


Variable of loop counter must not be used other than loop counter. 


ic_0491: Reuse of variables within a single Stateflow 
scope 





| 


(人 
Re 


Incorrecf 


The meaning of the variable i changes from the index of the loop 
counter to the sum of a+b 
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ic_0491: Reuse of variables within a single Stateflow 
scope 





A 


ME engSpd; 
engSpd = FikFuncltempVar) 


已 


[TRANS CALC “| ENG_CALC 
| 昌 


tempVar = tranSpd: 
tranSpd = FFuncltempVar): 





[Ta STRRTDoaipewep[baai 


国 lempVat Local ER 杞 32 


Correcf 


tempVvar is defined as local scope in both SubState _Aand SubState _B. 


Raftionale 。Readability 
e Workflow 


e Code Generation 


Lastf V2.0 
Changed 
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ic_0491: Reuse of variables within a single Stafteflow 
scope 





Model Not applicable 
Advisor 
Check 
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ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Rafionale 


jc 0541: Use of tunable parameters in Stateflow 
Strongly recommended 
MAAB 


All 


None 


Tunable parameters should be included in a Chart as inputs from the 
Simulink model. 


















Constant [param1 。 put 
Chart 
Correct 
[ 知 param1 Constant 
| Name jsope | 
Chart [ 富 param11 Parameter 
Incorrect 


e Readability 
e Workflow 


e (Code Generation 


ic_0541: Use of ftunable Parameters in Stafeflow 





Last 
Changed 


Model 
Advisor 
Check 


V2.0 


By Task > Modeling Standardqs for MAAB > Stateflow >“Check 
for tunable parameters in Stateflow charts?” 
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ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Raftionale 


db_0127: MATLAB commands in Stateflow 
Mandatory 
MAAB 


All 


None 


The following rules apply to logic in Stateflow: 


e。 MATLAB functions are not used. 
e。 MATLAB instructions are not used. 


e。 MATLAB operators are not used. 


e Project-specific MATLAB functions are not used. 


XYTrac 
du: 


xForce = WheelTqTot heelAng') 
yForce = WheelTqTot heelAng) 





Incorrecf 


e Readability 
e Workflow 


db 0127: MATLAB commands in Statfeflow 





Last 
Changed 


Model 
Advisor 
Check 


e Verification and Validqation 


e (Code Generation 


V2.0 


By Task > Modeling Standardqds for MAAB > Stateflow >“Check 
for MATLAB expressions in Stateflow charts?” 
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ID: Title jm_0011: Pointers in Stateflow 
Priorify Strongly recommended 
Scope MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion In a Stateflow diagram, pointers to custom code variables are not 
allowed. 

Raftionale 。Readability 
e Workflow 


e Verification and Validqation 


e (Code Generation 


Last V1.0 

Changed 

Model By Task > Modeling Standardqds for MAAB > Stateflow >“Check 
Advisor for pointers in Stateflow charts?” 

Check 
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im_0011: Pointers in Stateflow 





Eventfs 


e db 0126: Scope of events 


e jm 0012: Event broadcasts 


6-39 


db 0126: Scope of events 





ID: Tiftle 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


Raftionale 


Last 
Changed 


Model 
Advisor 
Check 
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db _0126: Scope of events 
Mandatory 
MAAB 


All 


None 


The following rules apply to events in Stateflow: 


e All events of a Chart must be defined on the chart level or lower. 


e There is no event on the machine level (i.e. there ls no interaction 
with local events between different charts). 


Specifics 
e Readability 


e Workflow 


e Verification and Validqation 


V2.0 


By Task > Modeling Standardqds for MAAB > Stateflow >“Check 
whether Stateflow events are dqefined at the chart level or 
belovw2” 


im_0012: Event broadcasts 





ID: Tifle 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


]m_0012: Event broadcasts 
Strongly recommended 
MAAB 


All 


db 0126: Scope of events 


The following rules apply to event broadcasts in Stateflow: 


e Directed event broadcasts are the only type of event broadcasts 
allowed. 


e The send syntax or qualified event names are used to direct the event 
to a particular state. 


e Multiple send statements should be used to direct an event to more 
than one state. 





Example Using Send Syntax 
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im_0012: Eventf broadcasts 





A 间 
凡 1 尼 E1 上 2 
” B 
[B1 E1 B2 


Example Using Qualified Event Names 


Raftionale 。Readability 
e Workflow 
e Verification and Validqation 


e (Code Generation 


Last V1.0 

Changed 

Model By Task > Modeling Standardqds for MAAB > Stateflow > “Check 
Advisor for event broadcasts in Stateflow charts?” 

Check 
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im_0012: Event broadcasfts 





Stfatechart Patferns 


e db 0150: State machine patterns for conditions 


ee db 0151: State machine patterns for transition actions 
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ID: Tiftle 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


db_0150: State machine patterns for conditions 
Strongly recommended 
MAAB 


All 


None 


The following patterns are used for condqitions within Stateflow state 
Imachinesg: 





Equivalent State Machine Pattern 
Funcfionality 





One condition: 


(condition) 开 [condition] B 
[ 








db 0150: State machine patterns for conditions 





Raftionale 





Equivalent 
Funcfionality 


State Machine Pattern 





Up to three conditions， 
Short form: 


(The use of different 
loglcal operators in this 
form is not allowed. Use 
Subconditions Instead.) 


(condition1 && 
condition2) 
(condition1 || 
condition2) 


[condiion1 && condition2] 





[condiion1| condiion] B 








Two or more conditions， 
multiline form: 


A subcondition ls a set of 
logical operations, all of 
the same type, enclosed 
In parentheses， 


(The use of different 
operators in thils form 
ls not allowed.，Use 
Subconditions Instead.) 


(condition1l 

&& condition2 ..， 
&& condition3) 
(condition1l 

|| condition2 ... 
|| condition3) 





[condition1 
&& condition2 
&& conditiong] B 





[condiion1 
| condibon2 


| |condition3] 人 


一 


人 





e Readability 
e Workflow 
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db 0150: State machine patterns for conditions 





e Verification and Validqation 


Lasft V2.0 
Changed 

Model Not applicable 
Advisor 

Check 
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db 0151: State machine patterns for fransition acfions 





ID: Title db_0151: State machine patterns for transition actions 
Priorify Strongly recommended 

Scope MAAB 

MATLAB All 

Versions 


Prerequisites ”None 


Descripfion The following patterns are used for transition actions within Stateflow 


state machlines: 





Equivalent Funcftionality 


State Machine Pafttern 





One translition actlon: 


action 


[一 





Two or more ftanslition 
actions, multiline form: 


(Two or more transition 
actions In one line are not 
allowed.) 


action1 ; 
action2 ; 
action3 ; 





jaction1: 
action2: 


一 
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db 0151: State machine paftterns for fransition acfions 





Raftionale 。Readability 
e Workflow 


e Verification and Validqation 


Lasf V1I.0 
Changed 

Model By Task > Modeling Standardqds for MAAB > Stateflow >“Check 
Advisor transition actions in Stateflow charts?” 

Check 
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db 0151: State machine patterns for fransition acfions 





Flowcharf Paftterns 


。 db 0148: 
。db_ 0149: 
。 db 0134: 
。 db 0159: 
。 db 0135: 


The precedqing guidelines illustrate sample patterns used in fow charts. 
As such, they would normally be part of a much larger Stateflow 


diagram， 


FLowchart 
FLowchart 
FLowchart 
FLowchart 


FLowchart 


patterns for 
patterns for 
patterns for 
patterns for 


patterns for 


conditions 
condition actions 
If constructs 
case constructs 


1oop constructs 
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ID: Title 


Priority 

Scope MAAB 
MATLAB All 
Versions 
Prerequisites ”None 
Descripfion 


db_0148: Flowchart patterns for conditions 


Strongly recommended 


Use the following patterns for conditions within Stateflow Flowcharts: 





Equivalent Funcfionality 


Flowchart Pattern 





One condition: 


[condition] 


[conditiomn] 


产 Comment ?3 
[conditiom] 





Up to three condlitions，short 
form 


(The use of qifferent logical 
operators in this form ls not 
allowed. Use subconditions 
instead.) 


[conditionl 
&& condition2 
&& condition31] 
[condition1l 
|| condition2 
[| condition3] 





[condition1 && condition2 && condition3 


C 一 OO 





[condition1 || condition2 | condition3 


O 





db 0148: Flowchart patterns for conditions 








Equivalent Funcfionality 


Flowchart Pattern 





Two or more conditions， 
multiline form: 


(The use of different logical 
operators in this form is not 
allowed， Use subconditions 
instead.) 


[condition1 

&& condition2 ..， 
&& condition3] 
[conditionl 

[| condition2 ... 
|| condition3] 


[condition1 .… 
&& condition2 .… 
&& condition3] 


[condition1 .… 
| condition2 .… 
| condition3] 


声名 





Conditions with subconditions: 


(The use of different 
loglcal operators to connect 
Subconditions ls not allowed. 
The use of brackets is 
mandatory.,) 


[(condition1a 

[| condition1b ) 
&& (condition2a 
[| condition2b ) 
&& (condition3) ] 
[(condition1a 
&& condition1b ) 
[| (condition2a 
&& condition2b ) 
[| (condition3) ] 





[condition1a condition1b) 
&& Icondition2a | condition2b) 
&& condition3] 


[condition1a && condition1b) 
Icondition2a && condition2b) 
| condition3] 





db 0148: Flowchart patterns for condiftions 








Equivalent Functionality Flowchart Pattern 





Conditions that are visually 


Separated: 


[conditiond] [condition2] 
(This form may be combined 


with the preceding patterns.) 











[conditionl 
&& condition21] 
[conditionl 
4 [condition1] 
V _ [condition2] 
Raftionale 。Readability 
e Workflow 
e Verification and Validqation 
Lasf V2.0 
Changed 
Model Not applicable 
Advisor 
Check 
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ID: Tiftle 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


Descripfion 


db_0149: Flowchart patterns for condqition actions 
Strongly recommended 
MAAB 


All 


None 


You should use the following patterns for condition actions within 
Stateflow Flowcharts: 
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db 0149: Flowchart patterns for condifion actions 








Equivalent Funcfionality Flowchart Pattern 





One condition action: 
action; 
产 Comment 写 


嘿 
actlon， { ， 
]} actlon: 


} 





Two or more condition actions, multiline 


form 

(Two or more condition actions lin one line { 
are not allowed.) action1 
action2， 


gction3: 


} 


action1 ; 
action2 ; 
action3 ; 





Condition actions, that are visuUally 


Separated: mm 
(This form may be combined with the { 
preceding patterns.) action1a: 
action1b， 
action1a; } 
action1b ; 
action2 ; )》 
action3 ; { 
action2: 
} 
《 
{ 
action3; 
} 
() 
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db 0149: Flowchart patterns for condifion acfions 





Raftionale 


Last 
Changed 


Model 
Advisor 
Check 


e Readability 
e Workflow 


e Verification and Validqation 


V1.0 


Not applicable 
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ID: Title db_0134: Flowchart patterns for If constructs 
Priorify Strongly recommended 

Scope MAAB 

MATLAB All 

Versions 


Prerequisites db_0148: Flowchart patterns for conditions 


db 0149: FlLlowchart patterns for condition actions 








Descripfion Use the following patterns for If constructs within Stateflow Flowcharts: 
Equivalent Functionality Flowchart Pattern 
If then 
if (condition){f actioni 《2 
} 
V [condiionm] 
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db 0134: Flowchart patterns for If consfrucfts 








Equivalent Functionality 


Flowchart Pattern 





If then else 


if (condition)t{ action1; 
】} 
else 1{ 

action2 ; 


} 


[condition] 


) 

{ | 
action2 action1 

} 


wm 





If then else If 


If (condition1)1{ action1; 


} 


else if (condition2) { action2; 


】} 
else if (condition3){ 
_ action3; 
} 
elSse 1{ 
action4; 


} 
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db 0134: Flowchart patterns for If consfructs 








Equivalent Functionality 


Flowchart Pattern 





Cascade of if then 


if (condition1){ action1 ; 





(jc 一 ( 】 








工 咎 (condition2){ action2 ; [condmon1l] -~- 
if (condition3){ action3; ee 
】} | CO 
} 人 [condmonz2] 
aa 办 似 基 
Raftionale 。Readability 
e Workflow 
ee Verification and Validqation 
Lasft V1.0 
Changed 
Model Not applicable 
Advisor 
Check 
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ID: Title 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


db_0159: Flowchart patterns for case constructs 
Strongly recommended 
MAAB 


All 


db 0148: Flowchart patterns for conditions 


db 0149: Flowchart patterns for condition actions 
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db 0159: Flowchart paftterns for case consfrucfts 





Descripfion Use the following patterns must be used for case constructs within 
Stateflow Flowcharts: 

















Equivalent Functionality Flowchart Pattern 
case with excluslve selection 
Selection = ...; 7 
Switch (selection) t ER 
{ 间 
case 1: V selection == ] 
action1 ; (人 () 
breaki | action1 
Case 2: 几 } 
action2 ; 娄 ， 呈 丰 你， (人 
久 1S6lecbhon >= 也 
break ; ) Et( ) 
case 3: action2 
action3 人 
昌 (一 
break ; V selecti AS - 
旦 1Selecbhon == 站 
defaujlt : 上 人 
action4 actionS 
} V } 
{ (六 
actiond T 
史 
上 和 
| } 
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db 0159: Flowchart patterns for caqse construcfts 








Equivalent Funcfionality 


Flowcharft Pattern 





case Wilith excluslve conditions 


cl1 = condition1 ; 

c2 = condition2 ; 

c3 = condition3 ; 

if (cl1 && !c2 && !c3) 

{ 

action1 ; 

} 

elseif (!c1 8&& c2 8&& !c3) 
{ 

action2 ; 

】} 

elseif (!c1 8&& !c2 && c3) 
{ 

action3 ; 

} 

esSe 

{ 

action4 ; 


} 





Bcliord4 


『 


ME | 
| clioni1; 
1 7 1 














Rafionale 


Last 
Changed 


e Readability 
e Workflow 


e Verification and Validqation 


V1.0 
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Model Not applicable 
Advisor 
Check 
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ID: Tiftle 
Priority 
Scope 


MATLAB 
Versions 


Prerequisites 


db_0135: Flowchart patterns for loop constructs 
Recommended 
MAAB 


All 


db 0148: Flowchart patterns for conditions 


db 0149: Flowchart patterns for condition actions 
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db 0135: Flowchart patterns for loop construcfs 





Descripfion Use the following patterns to create Loops within Stateflow Flowcharts: 





Equivalent Functionality | Flowchart Pattern 





for loop 


for (Index=0; 

index<number_ of _ loops 
index++) 站 泡 
{ OCS ctiofl 
actionj 


) 





while loop 


while (condition) ( 人 
{ [con diion] -一 


action; 2 











] 
CC 





do while loop 


do 


{ V 
action; 要务 
} 
While (condition) ; 
Fi { 
人 action， 
广 } 


[condibon] 、 





() 导 
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db 0135: Flowchart patterns for loop construcfs 





Raftionale 


Last 
Changed 


Model 
Advisor 
Check 


e Readability 
e Workflow 


e Verification and Validqation 


V1.0 


Not applicable 
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db 0135: Flowchart patterns for loop constructs 








Recommendatlons for 
Automation Tools 





These recommendationgs are for companies who develop tools that automate 
checking ofthe style guidelines. The MathWorks Automotive Advisory Board 
(MAAB) developed these recommendations for tool vendors who create tools 
developed with MathWorks tools that check models against these gulidelines. 
To provide maxlimum information to potential users of the tools, the MAAB 
strongly recommends that tool vendors provide a compliance matrix that 

is easily accessible while the tool is running. This information should be 
avallable without a need to purchase the tool. 


The compliance matrix should include the following information: 
e。 Version of the guidelines that are checked - shall include the complete 
title, as found on the title page of this dqocument. 
Include the MAAB Style Guidellines Title and Verslon document number， 
e Table consisting of the following information for each guidqeline: 
” Guideline ID 
” Guideline taitle 
”Level of compliance 
” Detall 


The gulideline ID and title shall be exactly as Included in thils document. The 
level of compliance shall be one of the following: 


人 及 _Recommendations for Aulomaiion Tools 

















Correctlion The tool checks and automatically or semilautomatically 
corrects the noncompliance. 

Check The tool checks and flags noncompliance. It is the dqevelopers 
responslbllity to make the correction . 

Partial The tool checks part of the guideline. The detail section 
should clearly identify what is and what is not checked. 

None The tool does not check the gulideline. The MAAB 


recommends that the vendor provide a recommendation of 
how to manually check guldqelines that the tool does not 
check. 








A 人 -2 





wuldeline Writing 


Guidelines with the following characteristlics are easiler to undqerstand and 
use. At a minimum，when writing a new guldqeline, lt should be 





Undqerstandable and 
unambilguous 


A guldeline's description should be precilse， 
clearly wordedq, concise, and Shouldq define a 
characteristic of a model (or part of a mode]) 
that a checking tool can evaluate. Use the words 
"must," "shall," "shouldq," and "may" carefully; 
they have distinct meanings that are Important 
for model developers and model checkers (human 
and automatedq). It is helpful to the reader 过 the 
guideline author describes how the conforming 
state can be reached (for example, by selecting 
particular options or cllicking a certalin button)， 
卫 xamples, counterexamples, plctures, diagrams， 
and Screen shots are also helpful and are 
encouraged. 


Minimize the allowable exceptions to a guldeline; 
exceptions blur a guideline and make it harder 
to apply. If a guidqeline has many allowable 
exceptions, you may be trying to cover too many 
characteristlics with one guldellne. (See Minimal， 
following, for some solutions.) 





Easy to find 





Minimal 





A guldeline should addqress only one model 
characteristic at a tme，Guldelines should 
be atomic. For example, instead of writing a 
big gulidqeline that addresses erTror prevention 
and readabillity at the same tme,， make 


B cuideline Writing 





卫 -2 





two guldellines，one that addqresses erTror 
prevention and one that addresses readability. 工 
appropriate, make one gulidqeline a prerequlsite 
of the other. Also, big guidelines are more likely 
than small guldelines to requlre compromilses 
for wide acceptance. Big guidelines may end up 
being weaker, less specific, and less beneficial. 
Small, focused guidqelines are less likely to 
change due to compromlse and easler adoption . 








Fljowchart Reference 


Use the patterns that appear in this appendix for if-then-else-if constructs 
within Stateflow Flowcharts. 


名 Flowchart Reference 
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Straight Line Flow Chart Pattern 


Curved Line Flow Chart Pattern 


















if then 
[conditiom] 
的 [conditionm] 
actlon: { 
} action' 
If then else 
称 
[conditionm] 
[conditiom] 
2 { 
action1 action1 
2 
劣 











Flowchart Reference 








if then else if 













[condition1] 


action1, 


[condiion 了 引 







action2; 


AN 
) { 
下 } 
2 action3， 
} } 
NM 
C(_) 





Cascade of if then 








[condition1] 
{ 

action1: 

} 
[condition2] 
{ 

action2， 

} 
[condition3] 
{ 

action3: 

】} 








C Flowchart Reference 
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The following patterns are used for case constructs within Stateflow 


Flowcharts: 





Straight Line Flow Chart Pattern 


Curved Line Flow Chart Pattern 





case with excluslve selection 














{ 
Se6lecDofi = 
用 elecion == 1 六 
乔 ， 人 
显 [5elecion == 习 
( 大 
[Selecion == 引 
( en- 
( | 
achond acion3，| scor acion1 
} } | } 
由 [7 凡 岂 
V 攻 攻 萎 
(_) 必 (jc 1 ) 吴 《 
旺 





当 
\ 
| | 
[cal [ 5 [ee Re 
和 | Se 局 用 么 习 598 辽 一 一 
ac0ord4 直 | 
ac aciora | Bonl 
| 1 
| 
| 
| | 
上 
nr 
sy 





Flowchart Reference 








case with excluslive conditions 










{ 

c1= condiion1 
cC2=condiion2; 
3 = condiion3; 


[18&&1c28&& IO 











C Flowchart Reference 





The following patterns are used for for loops within Stateflow Flowcharts: 























Siraight Line Flow Chart Pattern Curved Line Flow Chart Pattern 
for loop 

OO [ndex <number_of_loopsj  ， 人 ) 

Ri = 0 2 { 
5 index = 0 
TS } [ndex< number_of loops] 
RSS action 
性 } 到 Index++ 
Siraight Line Flow Chart Pattern Curved Line Flow Chart Pattern 





while loop 





[conditiom] 
[conditiom] 


{ 


| 
action: actlion: 


} 
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Flowchart Reference 








Siraight Line Flow Chart Pattern 


Curved Line Flow Chart Pattern 





do while loop 





actlon ， 


[conditiom] 
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@@ Flowchart Reference 





The following patterns are alternately used for If-then-else-if constructs 
within Stateflow Flowcharts: 





Straight Line Flow Chart Pattern Alternate Siraight Line Flow Chart Pattern 





If then else If 





[condiion1] 


[condiWionz] 


[condgion2] 


fondaon3l 
{ 办 攻 


acton4 action3，| action2; action1; 


/) 册 》 } } 
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Flowchart Reference 








Siraight Line Flow Chart Pattern 


Alfernate Siraight Line Flow Chart Pattern 





Cascade of if then 








[condonij 





C Flowchart Reference 





C-10 





Background lnformation on 
Baslc Blocks and Slgnals 





e “Basic Blocks” on page D-2 
e “Signals and Signal Labels” on page D-3 


D Background Information on Basic Blocks and Signals 





Basic Blocks 
This qocument uses the term basic Docps to refer to blocks built into the 
Simulink block libraries. The following table lists some examples of basic 


blocks. 


Basic Blocks 























Block Example 
Inport 人 LI 》 
Constant 加 
Gain > 
Sum 人) 
Switch 小 
Saturation 一 全 
Abs Iul 








Signals and Signal Labels 





Signals and Signal Labels 


Signals may be scalars, vectors, or busses. They may carTry data or control 
fows. 


You use signal labels to make model functionality more understandable from 
the Simulink qiagram. You can also use them to control the varlable names 
used in Simulation and code generation. Enter slgnal ljabels only once (at 

the point of signal origination). Often, you may want to also display the 
slgnal name elsewhere in the model. In these cases, the slgnal name should 
be inherited until the signal is functionally transformed. (Passing a signal 
through an integrator is functionally transforming. Passing a signal through 
an Inport into a nested subsystem is not.) Once a named signal is functionally 
transformed, associate a new name with jit. 


Unless expjlicitly stated otherwise, the gulidelines In “Signals”on page 5-30 
apply to all types of signals. 


For more information about the representation of signals in Simulink models， 
see“Working with Signals” in the Simulink qocumentation. 
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CC 





Acfions 
Actions are part of Stateflow diagram execution. The action can be 
executed as part of a transition from one state to another, or depending 
on the activity status of a state. Transitions can have condition actions 
and transltion actions, 上 or example， 


Condition Transition 
ac 本 on acftaon 


[Power-on Switch_off[ cl ]{elec_o 从 /light_of 作 





Ca 





N 


1 
站 
Power_off 





N 


States can have entry, during, exit, and, on event_mame actions. For 
example， 


f Power_0ry 
enmtryaction10- 
durin0': action201 
ex 让 action30: 
On SwWigch_o 丰 action40， 


\ 
If you enter the name and backslash followed directly by an action or 
actions (Without the entry keyword), the actions are Interpreted as entry 
actions. This shorthand is useful if you are specifying only entry actions. 


The action language defines the categories of actions you can specify 
and their associated notations. An action can be a function call，amn 
event to be broadcast, a variable to be asslgned a value, and so on. 
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Action Language 
Sometimes you want actions to take place as part of Stateflow diagram 
execution. The action can be executed as part of a transition 位 om one 
state to another, or it can qepend on the activity status of a state. 
Transitions can have condition actions and translition actions. States 
can have entry, during, exit, and, on event_mame actions. An action 
can be a function call, an event to be broadcast, a variable to be assigned 
a value，etc. 


The action ljanguage dqefines the categories of actions you can Specify and 
their associated notations. Violations of the action language notation 
are fagged as errors by the parser. This section qescribes the action 
language notation rules， 


Chart Instance 
Achart instance is a link fom a Stateflow model to a chart stored 
in a Simulink library. A chart in a library can have many chart 
instances. Updating the chart in the library automatically updates all 
the instances of that chart. 


Condition 
A condition is a Boolean expression to specify that a translition oOccur， 
given that the specified expression ls true. For example， 


metuftral 
dulch engaged 习 NS 


一 AR 
en030e6d { wh 


[speed > threshold [speed>threshold]jis a 


全 是 和 condition 
廿 mm 


The action language defines the notation to define conditions associated 
with transltions， 














Connecfive Juncftion 
Connective j]unctions are declslon polints in the system. A connective 
junction is a graphical object that simplifies Stateflow diagram 
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representations and facilitates generation of efficient code. Connective 
junctions provide alternative ways to represent the system behavilor you 
want. This example shows how connective ]unctions (displayed as small 
circles) are used to represent the flow of an if codqe structure. 


if [ci 
0 下 
这 1 ff 【[【C2]{ 
a2 
ee if [c3]{ 


， 
[c2]fa2} } 
[c3]{a3} 
Or the equivalent squared style 
cl if [cll{ 
Se al 
fa 中 if [fc2]{ 
[c3] a2 
CQ-_c ( }else if [c3]{ 
{33} a3 
广 } 
O 〇 } 
恨 工 JE 
{3adj 
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Name Button lcon | Description 
Connective One use of a Connective junction ls to 
]unctlon handle Situations where translitiongs 


out of one state into two or more states 
are taken based on the same event but 
guarded by different conditions. 











Data 
Data objects store numerical values for reference in the Stateflow 
diagram. 


Defining Data 
Astate machine can store and retrieve data that resldes internally in 
lts Own Workspace. It can also access data that resldes extermnally in the 
Simulink model or application that embeds the state machine, When 
creating a Stateflow model, you must dqefine any internal or external 
data referenced by the state machine's actions， 


Data Dictionary 
The dqata dictionary is a database where Stateflow diagram information 
is stored. When you create Stateflow diagram objects, the information 
about those objects is stored in the dqata dictionary, once you Save the 
Stateflow diagram. 


Decomposition 
A state has dqecomposition when it conslsts of one or more Substates. 
A Stateflow diagram that contaings at least one state also has 
decomposition. Representing hlierarchy necessltates some rules around 
how states can be grouped in the hierarchy. A superstate has elther 
parallel (AND) or excluslive (OR) qdqecomposition. All substates at a 
particular level in the hierarchy must be of the same dqecomposition . 


Parallel (AND) State Decomposition. Parallel (AND) state 
decomposition ls indlicated when states have dqashed borders. This 
representation ls appropriate 这 all states at that same level in the 
hierarchy are active at the same tme. The activlity within parallel 
states ls essentially Independent. 
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也 xclusive (OR) State Decomposition. Exclusive (OR) state 
decomposition 1s represented by states with solidq bordqers. 了 xcluslve 
(OR) decomposition ls used to describe system modes that are mutually 
exclusive,. Only one state, at the same level in the hierarchy, can be 
active at a tme. 


Default Transifion 
Default translitions are primarily used to specify which exclusive (OR) 
state is to be entered when there is ambiguity among two or more 
nelighboring exclusive (OR) states. For example, default trangsitions 
specify wphich substate of a sSuperstate with exclusive (OR) decomposition 
the System enters by default in the absence of any other information. 
Default transitiongs are also used to specify that a junction should be 
entered by qdqefault. A default transition is represented by selecting the 
default transition object from the toolbar and then dqropping it to attach 
to a destination object. The default transition object is a transition with 
a_ destination but no Source object. 





Name Buftiton Icon | Descripfion 
Default Use a Default transition to indicate， 
translitlon when entering this level in the 


hierarchy，which state becomes active 
by default. 











Evenfts 
Events drive the Stateflow diagram execution. Define all events that 
affect the Stateflow diagram. The occurrence of an event causes the 
status of the states in the Stateflow diagram to be evaluated. The 
broadcast of an event can trigger a transition to occur and/or can trigger 
an actlon to be executed. Events are broadcast in a top-down manner 
starting 位 om the event's parent in the hierarchy. 


Finite State Machine 
Atfinite state machine (FSM) is a representation of an event-driven 
System， FSMEs are also used to qdqescribe reactive Systems， JIn an 
event-dqriven or reactive System, the system transitions from one mode 
or state, to another prescribed mode or state, provided that the condition 
defining the change is true, 
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Flow Graph 
Aflow graph is the set of Flowcharts that start 位 om a transition 
Segment that, in turn， starts from a state or a dqefault transition 
Segment. 


Flowchart (also known as Flow Path) 
AT 了 Flowchart is an ordered sequence oftransition Segments and junctiongs 
Where each succeeding segment starts on the ]unction that terminated 
the previous segment. 


Flow Subgraph 
Atflow subgraph is the set of Flowcharts that start on the same 
translition segment， 


Hierarchy 
Using hlierarchy you can organlze complex systems by placing states 
within other higher-level states. A hierarchical qeslign usually reduces 
the number of transitions and produces neat, more manageable 
diagrams， 


History Juncftion 
A History Junction specifies the destination substate of a transition 
based on historical information. If a superstate has a History Junction， 
the transition to the destination substate is defined to be the substate 
that was most recently visited. The History Junction applies to the level 
of the hierarchy in which it appears. 








Name Butiton Icon | Descripfion 
History UseaHistory Junction to indlicate, when 
Junction entering thls level in the hierarchy, that 


the last state that was active becomes 
the next state to be active. 











Inner Transitions 
An inner trangslition 1s a transition that qdqoes not exlt the source state, 
Inner transitions are most powerful when defined for superstates with 
XOR decomposition. Use of inner transitions can greatly simplify a 
Stateflow diagram. 
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Library Link 
Alibrary link ls a linkto a chart that ls stored in a library model imn 
a Simulink block library， 


Library Model 
A Stateflow library model is a Stateflow model that is stored in a 
Simulink library. You can include charts from a library in youlr model 
by copying them. When you copy a chart from a library into your model， 
Stateflow does not physically include the chart in your model. Instead， 
lt creates a link to the library chart. You can create multiple ]inks to a 
single chart. Each link ls called a chart instance. When you include a 
chart from a library in your model, you also include its state machine. 
A Stateflow model that includqes links to library charts has multiple 
state machines. When Stateflow simulates a model that includes charts 
他 om a library model, it includes all charts from the library model even 
ithere are links to only some of its models. However, when Stateflow 
generates a stand-alone or Simulinke CoderIM target, it includqes only 
those charts for which there are links. A_ model that includes links to a 
library model can be simulated only 过 all charts in the library model are 
free of parse and compile errors. 


Machine 
A machine is the collection of all Stateflow blocks defined by a Simulink 
model exclusive of chart instances (library links). If a model includqes 
any library links, it also includqes the state machines defined by the 
models from which the links originate. 


Nonvirtual Block 
Blocks that perform a calculation, such as a Gain block. 


Notation 
A notation defines a set of objects and the rules that govern the 
relationships between those objects. Stateflow notation provides 3 
common ]anguage to communicate the qeslign information conveyed by a 
Stateflow diagram. Stateflow notation consists of 
e A set of graphical objects 


e。 A set of nongraphical text-based objects 


e。 Defined relationships between those objects 
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Parallelism 
A system with parallelljsm can have two or more states that can be 
active at the same time. The activity of parallel states is independent. 
Parallelism ls represented with a parallel (AND) state dqecomposition. 


Real-Time System 
A system that uses actual hardware to Implement algorithms, for 
example, digital slgnal processling or control applications, 


Simulink Coder 
Simulink Codqer software includes an automatic C language code 
generator for Simulink. It produces C code directly from Simulink block 
diagram models and automatically buildqs programs that can be run in 
real-time in a variety of environments. 


Simulink Coder Targef 
An executable built from code generated by the Simulink Coder product， 


S-funcfion 
Acustomized Simulink block written in C or MATLAB-code. S-functions 
written in C can be inlined in the Simulink Coder software. When using 
Simulink together with Stateflow for simulation， Stateflow generates 
an S-function (MEX-file) for each Stateflow machine to Support model 
simulation. Thils generated code 1s a Simulation target and ls called 
the S-Fun target within Stateflow. 


Signal propagaftion 
Process used by Simulink to determine attributes of signals and blocks， 
Such as data types, ]jabels, sample tme, dimenslonality, and So on, that 
are determined by connectivity. 


Signal source 
The signal source is the block of origin for a signal. The signal source 
may or may not be the true source. 


Simulink 
Simulink is a software package for modeling, simulating, and analyzing 
dynamilc systems. It Supports linealr and nonlinear Systems, modeled 
in continuous time, Sampled time, or a hybrid of the two. Systems camn 
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also be multirate, that ls, have different parts that are Sampled or 
updated at different rates， 


Simulink allows you to represent systems as block diagrams that you 
build using your mouse to connect blocks and your keyboard to edit 
block parameters. Stateflow is part of this environment. The Stateflow 
block is a masked Simulink model. Stateflow buildqs an S-function that 
corresponds to each Stateflow machine. This S-function is the agent 
Simulink interacts with for Simulation and analysls. 


The control behavior that Stateflow models complements the algorithmic 
behavior modeled in Simulink block diagrams. By Incorporating 
Stateflow diagrams into Simulink models, you can add event-qriven 
behavior to Simulink simulations. You create models that represent 
both data and control flow by combining Stateflow blocks with the 
standard Simulink blockset. These combined models are simulated 
Using Simulink. 


State 
A state dqescribes a mode of a reactive System. A reactive System has 
many possible states. States in a Stateflow diagram represent these 
modes. The activity or inactivity of the states dqynamically changes 
based on events and conditions. 


Every state has hierarchy. In a Stateflow diagram consisting of a 
single state, that state"s parent ls the Stateflow diagram itself. A state 
also has history that applies to its level of hierarchy in the Stateflow 
diagram. States can have actions that are executed in a sequence based 
Upon action type. The action types are: entry, during, exit, or on 
event_mame actions. 














Name Butiton Icon | Descripfion 
State Use a state to dqepict a mode of the 
System . 





Stiateflow Block 
The Stateflow block is a masked Simulink model and is equivalent to an 
empty, untitled Stateflow diagram. Use the Stateflow block to include a 
Stateflow diagram in a Simulink model. 
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The control behavior that Stateflow models complements the 
algorithmilic behavior modeled in Simulink block diagrams， By 
incorporating Stateflow blocks into Simulink modqels, you can add 
complex event-dqriven behavior to Simulink simulations. You create 
models that represent both qata and control flow by combining Stateflow 
blocks with the standard Simulink and toolbox block libraries. These 
combined models are siimulated using Simulink. 


Stateflow Debugger 
Use the Stateflow Debugger to debug and animate your Stateflow 
diagrams. Each state in the Stateflow diagram simulation is evaluated 
for overall codqe coverage. This coverage analysis is done automatically 
when the target 1s compilled and bullt with the debug options. The 
Debugger can also be used to perform dynamic checking. The Debugger 
operates on the Stateflow machine. 


Stateflow Diagram 
Using Stateflow, you create Stateflow diagrams. A Stateflow diagram is 
also a graphical representation of a finite state machine where states 
and transitions form the basic buildqing blocks of the system. 


Stateflow Explorer 
Use the Stateflow 了 xplorer to addq, remove, and modify dqata，event， 
and target objects. 


Stiateflow Finder 
Use the Findqer to qisplay a list of objects based on Search criteria that 
you specify. You can directly access the properties qialog box of any 
object in the search output display by cllicking on that object. 


Substate 
Asastate ls a Substate if it ls contained by a Superstate. 
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Superstate 


Substate 


Superstate 
Astate 1ls a Superstate if it contains other states, called substates. 


Substate 


Substate 





Superstate 


Substate 





Target 
An executable program built 位 om code generated by Stateflow or 
Simulink Coder software. 


Top-down Processing 
Top-dqown processing refers to the way in which Stateflow processes 
states. In particular, Stateflow processes Superstates before states. 
Stateflow processes a state only if its Superstate ls activated first. 


Transition 
Atransitlion qescribes the circumstances under whlich the system moves 
位 om one state to another. Either end of a transition can be attached to 
a source and a destination object. The source 18 where the transltion 
begins and the dqestination is where the transition endqs. It is often the 
occurrence of some event that causes a transition to take place. 


Transition Path 
Atransition path 1s a Flowchart that starts and ends on a state. 
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Transition Segment 


Atransition segment is a single qirected edge on a Stateflow diagram. 
Transition segments are sometimes loosely referred to as transitions. 


Tunable paramefters 


Atunable parameter 1s a parameter that can be aqjusted in the model 
and in generated code， 


True Source 


The true source ls the block which creates a signal. The true source 1S8 
different from the signal source because the Signal source may be & 
slmple routing block such as a Demux block. 


Virtual Block 


When creating models, be aware that Simulink blocks fall into two 
basic categories: nonvlrtual and virtual blocks. Nonvirtual blocks play 
an active role in the simulation of a system. If you add or remove &a 
nonvirtual block, you change the models behavilor. Vilrtual blocks, by 
contrast, play no active role in the simulation. They help to organilze 

a model graphically. Some Simulink blocks can be virtual in some 
circumstances and nonvirtual in others. Such blocks are called 
conditionally virtual blocks. The following table lists Simulinks virtual 
and conditionally virtual blocks, 


Block Name 


Condition Under Which Block ls Virtual 





Bus Selector 


Virtual if input bus is virtual 





Demux 


Always virtual 





Enabljle 


Virtual unless connected directly to an Outport block 





From 


Always virtual 





Goto 


Always virtual 





Goto Tag 
Vislibllity 


Always virtual 





Ground 


Always virtual 





Inport 





Virtual when the block resides within any subsystem 
block (conditional or not), and dqoes not reslde in the 
root (top-level) Simulink window. 
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Block Name | Condition Under Which Block ls Virtual 

MUux Always virtual 

Outport Virtual when the block resldes within any subsystem 
block (conditional or not), and dqoes not reslde in the 
root (top-level) SIimulink window. 

Selector Virtual except in matrix mode 

Signal Always virtual 

Specification 

Subsystem Virtual unless the block ls conditionally executed 
and/or the block's Treat as Atomalc Unit option 1S 
selected. 

Terminator Always virtual 

Trigger Virtual ifthe Outport port is not present. 








Virfual Scrollbar 


Using a Virtual scrollbar, you can set a value by scrolling through a list 
of cholces. When you move the mouse over a menu item with a Virtual 
Scrollbar, the cursor changes to a line with a qdqouble arrowhead. Virtual 
scrollbars are either vertical or horizontal. The direction ls indicated by 
the positioning of the arrowheads. Drag the mouse either horizontally 
or vertically to change the value. 
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